Required API Keys - BIBSYSDEV/pipeline-builder GitHub Wiki
Required API keys:
The service allows integration with Github and it creates a REST documentation page in SwaggerHub. Therefore we need to store in AWS 4 API keys.
- An API-key to read from Github.
- An API-key that will allow Github to send requests to AWS (Github webhook).
- An API-key for the REST-API of the service that allows arbitrary creations and deletions of AWS stacks.
- An API-key to read from and write to SwaggerHub.
All API-keys are stores as Secrets in SecretsManager. All Secrets are of the type Other type of secrets and are stored as key-value pairs
Github keys
We need to store two keys for Github. One for reading from Github, and one for enabling Github to send requests to our service.
Reading from Github
- In your Github account page, navigate to Account Settings -> Developer Settings -> Personal access tokens and create an API-key
- Create a new Secret with name
infrastructure - Store a new key-value pair with key
read_from_githuband value the the generated github key.
API-key for Github webhook
- Go to the previously generated Secret
infrastructure - Add a new key-value pair with key
github_webhook_authorizationand as a value an arbitrary String.
SwaggerHub Key
- Create an API-key for your SwaggerHub account
- Navigate to the secret with name
infrastructure - Store a new key-value pair with key
swaggerapikeyand value the SwaggerHub generated key
REST-service key
- Navigate to the secret with name
infrastructure - Store a new key-value pair with key
buildbranchand value an arbitrary string.