/cloud-service-certification

Cloud Service Certification Project

Primary LanguageHCLApache License 2.0Apache-2.0

FINOS - Incubating

Cloud Service Certification

Enable banks to use services provided by AWS, Azure and Google in a way that meets existing regulatory and internal security controls.

Project Kanban

Find the Cloud Service Certification Project Kanban in the parent FINOS organisation on GitHub.

Project Wiki

We're currently migrating Cloud Service Certification reference materials from the FINOS wiki to the Cloud Service Certification GitHub wiki.

Please use the links below to find Cloud Service Certification materials.

Project Structure

The project is expected to grow to cover the different CSP (Cloud Service Providers) and in turn services for each of the providers. The project structure maps this hierarchy of CSPs -> Services.

Each service folder will contain markdown files (the service control description), test cases documentation and ultimately infrastructure-as-code (e.g. cloud formation or Terraform configuration). Where applicable, pre-existing source documents (e.g. docx) are stored within "archive" folders under the indidivual service folders.

Contributing

Forking, Feature Branches and Pull Requests

  1. Fork it (https://github.com/finos-fdx/cloud-service-certification/fork)
  2. Create your feature branch (git checkout -b feature/fooBar)
  3. Read our contribution guidelines and Community Code of Conduct
  4. Commit your changes (git commit -am 'Add some fooBar')
  5. Push to the branch (git push origin feature/fooBar)
  6. Create a new Pull Request

Service Approval Accelerator

The Service Approval Accelerator describes each service contributed to Cloud Service Certification alongside test cases and infrastructure as code.

A single Service Approval Accelerator document should be contributed with every service contributed to Cloud Service Certifcation.

See AWS Redshift example below.

Contributed Cloud Service by Example, AWS Redshift

The AWS RedShift Service Definition has been created to demonstrate through example the assets required with each service contribution to Cloud Service Certification.

Tips

Converting DocX to Markdown

After several tests, the best results to convert input .docx (Microsoft Word Documents) was achieved by using the Pandoc cmdline tool using the gfm (Github flavored Markdown) as output format.

For example, after installing Pandoc, using templates/archive/ServiceApprovalAccelerator_template_draftrelease.docx as input, we obtain as output templates/ServiceApprovalAcceleratorTemplate.md with the following command:

pandoc -s ServiceApprovalAccelerator_template_draftrelease.docx -t gfm -o ServiceApprovalAcceleratorTemplate.md

See this thread for reference.

License

Distributed under the Apache License, Version 2.0.

SPDX-License-Identifier: Apache-2.0