Add docs for GithubAppConfig

This commit is contained in:
Johan Haals
2021-01-14 10:44:52 +01:00
parent 820430b220
commit ca875e6658
+21
View File
@@ -67,13 +67,34 @@ export type GitHubIntegrationConfig = {
apps?: GithubAppConfig[];
};
/**
* The configuration parameters for authenticating a GitHub Application.
* A Github Apps configuration can be generated using the `backstage-cli create-github-app` command.
*/
export type GithubAppConfig = {
/**
* Unique app identifier, found at https://github.com/organizations/$org/settings/apps/$AppName
*/
appId: number;
/**
* The private key is used by the GitHub App integration to authenticate the app.
* A private key can be generated from the app at https://github.com/organizations/$org/settings/apps/$AppName
*/
privateKey: string;
/**
* Webhook secret can be configured at https://github.com/organizations/$org/settings/apps/$AppName
*/
webhookSecret: string;
/**
* Found at https://github.com/organizations/$org/settings/apps/$AppName
*/
clientId: string;
/**
* Client secrets can be generated at https://github.com/organizations/$org/settings/apps/$AppName
*/
clientSecret: string;
};
/**
* Reads a single GitHub integration config.
*