@backstage/integration 2.0.3 → 2.1.0-next.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/config.d.ts DELETED
@@ -1,458 +0,0 @@
1
- /*
2
- * Copyright 2020 The Backstage Authors
3
- *
4
- * Licensed under the Apache License, Version 2.0 (the "License");
5
- * you may not use this file except in compliance with the License.
6
- * You may obtain a copy of the License at
7
- *
8
- * http://www.apache.org/licenses/LICENSE-2.0
9
- *
10
- * Unless required by applicable law or agreed to in writing, software
11
- * distributed under the License is distributed on an "AS IS" BASIS,
12
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
- * See the License for the specific language governing permissions and
14
- * limitations under the License.
15
- */
16
-
17
- export interface Config {
18
- /**
19
- * Configuration for integrations towards various external repository provider systems
20
- * @visibility frontend
21
- */
22
- integrations?: {
23
- /** Integration configuration for Azure */
24
- azure?: Array<{
25
- /**
26
- * The hostname of the given Azure instance
27
- * @visibility frontend
28
- */
29
- host: string;
30
-
31
- /**
32
- * The credentials to use for requests. If multiple credentials are specified the first one that matches the organization is used.
33
- * If no organization matches the first credential without an organization is used.
34
- *
35
- * If no credentials are specified at all, either a default credential (for Azure DevOps) or anonymous access (for Azure DevOps Server) is used.
36
- */
37
- credentials?: {
38
- organizations?: string[];
39
- clientId?: string;
40
- /** @visibility secret */
41
- clientSecret?: string;
42
- tenantId?: string;
43
- /** @visibility secret */
44
- personalAccessToken?: string;
45
- managedIdentityClientId?: string;
46
- }[];
47
- /**
48
- * PGP signing key for signing commits.
49
- * @visibility secret
50
- */
51
- commitSigningKey?: string;
52
- }>;
53
-
54
- /** Integration configuration for Azure Blob Storage */
55
- azureBlobStorage?: Array<{
56
- /**
57
- * The name of the Azure Storage Account, e.g., "mystorageaccount".
58
- */
59
- accountName?: string;
60
-
61
- /**
62
- * The primary or secondary key for the Azure Storage Account.
63
- * Only required if connectionString or SAS token are not specified.
64
- * @visibility secret
65
- */
66
- accountKey?: string;
67
-
68
- /**
69
- * A Shared Access Signature (SAS) token for limited access to resources.
70
- * @visibility secret
71
- */
72
- sasToken?: string;
73
-
74
- /**
75
- * A full connection string for the Azure Storage Account.
76
- * This includes the account name, key, and endpoint details.
77
- * @visibility secret
78
- */
79
- connectionString?: string;
80
-
81
- /**
82
- * Optional endpoint suffix for custom domains or sovereign clouds.
83
- * e.g., "core.windows.net" for public Azure or "core.usgovcloudapi.net" for US Government cloud.
84
- */
85
- endpointSuffix?: string;
86
-
87
- /**
88
- * Optional endpoint URL for custom domain. Uses default if not provided.
89
- * @visibility frontend
90
- */
91
- endpoint?: string;
92
- /**
93
- * Optional credential to use for Azure Active Directory authentication.
94
- */
95
- aadCredential?: {
96
- /**
97
- * The client ID of the Azure AD application.
98
- */
99
- clientId: string;
100
-
101
- /**
102
- * The tenant ID for Azure AD.
103
- */
104
- tenantId: string;
105
-
106
- /**
107
- * The client secret for the Azure AD application.
108
- * @visibility secret
109
- */
110
- clientSecret: string;
111
- };
112
- }>;
113
-
114
- /** Integration configuration for Bitbucket Cloud */
115
- bitbucketCloud?: Array<{
116
- /**
117
- * The username to use for authenticated requests.
118
- */
119
- username?: string;
120
- /**
121
- * Token used to authenticate requests.
122
- * @visibility secret
123
- */
124
- token?: string;
125
- /**
126
- * Bitbucket Cloud app password used to authenticate requests.
127
- * @visibility secret
128
- * @deprecated Use `token` instead.
129
- */
130
- appPassword?: string;
131
- /**
132
- * OAuth client ID for Bitbucket Cloud.
133
- * @visibility secret
134
- */
135
- clientId?: string;
136
- /**
137
- * OAuth client secret for Bitbucket Cloud.
138
- * @visibility secret
139
- */
140
- clientSecret?: string;
141
- /**
142
- * PGP signing key for signing commits.
143
- * @visibility secret
144
- */
145
- commitSigningKey?: string;
146
- }>;
147
-
148
- /** Integration configuration for Bitbucket Server */
149
- bitbucketServer?: Array<{
150
- /**
151
- * The hostname of the given Bitbucket Server instance
152
- * @visibility frontend
153
- */
154
- host: string;
155
- /**
156
- * Token used to authenticate requests.
157
- * @visibility secret
158
- */
159
- token?: string;
160
- /**
161
- * Username used to authenticate requests with Basic Auth.
162
- * @visibility secret
163
- */
164
- username?: string;
165
- /**
166
- * Password (or token as password) used to authenticate requests with Basic Auth.
167
- * @visibility secret
168
- */
169
- password?: string;
170
- /**
171
- * The base url for the Bitbucket Server API, for example https://<host>/rest/api/1.0
172
- * @visibility frontend
173
- */
174
- apiBaseUrl?: string;
175
- /**
176
- * PGP signing key for signing commits.
177
- * @visibility secret
178
- */
179
- commitSigningKey?: string;
180
- }>;
181
-
182
- /** Integration configuration for Gerrit */
183
- gerrit?: Array<{
184
- /**
185
- * The hostname of the given Gerrit instance
186
- * @visibility frontend
187
- */
188
- host: string;
189
- /**
190
- * The base url for the Gerrit instance.
191
- * @visibility frontend
192
- */
193
- baseUrl?: string;
194
- /**
195
- * The gitiles base url.
196
- * @visibility frontend
197
- */
198
- gitilesBaseUrl: string;
199
- /**
200
- * The base url for cloning repos.
201
- * @visibility frontend
202
- */
203
- cloneUrl?: string;
204
- /**
205
- * Disable the edit url feature.
206
- * @visibility frontend
207
- */
208
- disableEditUrl?: boolean;
209
- /**
210
- * The username to use for authenticated requests.
211
- * @visibility secret
212
- */
213
- username?: string;
214
- /**
215
- * Gerrit password used to authenticate requests. This can be either a password
216
- * or a generated access token.
217
- * @visibility secret
218
- */
219
- password?: string;
220
- /**
221
- * PGP signing key for signing commits.
222
- * @visibility secret
223
- */
224
- commitSigningKey?: string;
225
- }>;
226
-
227
- /** Integration configuration for GitHub */
228
- github?: Array<{
229
- /**
230
- * The hostname of the given GitHub instance
231
- * @visibility frontend
232
- */
233
- host: string;
234
- /**
235
- * Token used to authenticate requests.
236
- * @visibility secret
237
- */
238
- token?: string;
239
- /**
240
- * The base url for the GitHub API, for example https://api.github.com
241
- * @visibility frontend
242
- */
243
- apiBaseUrl?: string;
244
- /**
245
- * The base url for GitHub raw resources, for example https://raw.githubusercontent.com
246
- * @visibility frontend
247
- */
248
- rawBaseUrl?: string;
249
-
250
- /**
251
- * GitHub Apps configuration
252
- */
253
- apps?: Array<{
254
- /**
255
- * The numeric GitHub App ID, string for environment variables
256
- */
257
- appId: number | string;
258
- /**
259
- * The private key to use for auth against the app
260
- * @visibility secret
261
- */
262
- privateKey: string;
263
- /**
264
- * The secret used for webhooks
265
- * @visibility secret
266
- */
267
- webhookSecret?: string;
268
- /**
269
- * The client ID to use
270
- */
271
- clientId: string;
272
- /**
273
- * The client secret to use
274
- * @visibility secret
275
- */
276
- clientSecret: string;
277
- /**
278
- * List of installation owners allowed to be used by this GitHub app. The GitHub UI does not provide a way to list the installations.
279
- * However you can list the installations with the GitHub API. You can find the list of installations here:
280
- * https://api.github.com/app/installations
281
- * The relevant documentation for this is here.
282
- * https://docs.github.com/en/rest/reference/apps#list-installations-for-the-authenticated-app--code-samples
283
- */
284
- allowedInstallationOwners?: string[];
285
- /**
286
- * If true, then an installation token will be issued for access when no other token is available.
287
- */
288
- publicAccess?: boolean;
289
- }>;
290
- }>;
291
-
292
- /** Integration configuration for GitLab */
293
- gitlab?: Array<{
294
- /**
295
- * The host of the target that this matches on, e.g. "gitlab.com".
296
- *
297
- * @visibility frontend
298
- */
299
- host: string;
300
- /**
301
- * The base URL of the API of this provider, e.g.
302
- * "https://gitlab.com/api/v4", with no trailing slash.
303
- *
304
- * May be omitted specifically for public GitLab; then it will be deduced.
305
- *
306
- * @visibility frontend
307
- */
308
- apiBaseUrl?: string;
309
- /**
310
- * The authorization token to use for requests to this provider.
311
- *
312
- * If no token is specified, anonymous access is used.
313
- *
314
- * @visibility secret
315
- */
316
- token?: string;
317
- /**
318
- * The baseUrl of this provider, e.g. "https://gitlab.com", which is
319
- * passed into the GitLab client.
320
- *
321
- * If no baseUrl is provided, it will default to https://${host}.
322
- *
323
- * @visibility frontend
324
- */
325
- baseUrl?: string;
326
- /**
327
- * PGP signing key for signing commits.
328
- * @visibility secret
329
- */
330
- commitSigningKey?: string;
331
-
332
- /**
333
- * Retry configuration for requests.
334
- * @visibility frontend
335
- */
336
- retry?: {
337
- /**
338
- * Maximum number of retries for failed requests.
339
- * @visibility frontend
340
- */
341
- maxRetries?: number;
342
- /**
343
- * HTTP status codes that should trigger a retry.
344
- * @visibility frontend
345
- */
346
- retryStatusCodes?: number[];
347
- /**
348
- * Maximum number of API requests allowed per minute. Set to -1 to disable rate limiting.
349
- * @visibility frontend
350
- */
351
- maxApiRequestsPerMinute?: number;
352
- };
353
- }>;
354
-
355
- /** Integration configuration for Google Cloud Storage */
356
- googleGcs?: {
357
- /**
358
- * Service account email used to authenticate requests.
359
- */
360
- clientEmail?: string;
361
- /**
362
- * Service account private key used to authenticate requests.
363
- * @visibility secret
364
- */
365
- privateKey?: string;
366
- };
367
-
368
- /** Integration configuration for AWS S3 Service */
369
- awsS3?: Array<{
370
- /**
371
- * AWS Endpoint.
372
- * The endpoint URI to send requests to. The default endpoint is built from the configured region.
373
- * @see https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#constructor-property
374
- *
375
- * Supports non-AWS providers, e.g. for LocalStack, endpoint may look like http://localhost:4566
376
- * @visibility frontend
377
- */
378
- endpoint?: string;
379
-
380
- /**
381
- * Whether to use path style URLs when communicating with S3.
382
- * Defaults to false.
383
- * This allows providers like LocalStack, Minio and Wasabi (and possibly others) to be used.
384
- * @visibility frontend
385
- */
386
- s3ForcePathStyle?: boolean;
387
-
388
- /**
389
- * Account access key used to authenticate requests.
390
- */
391
- accessKeyId?: string;
392
- /**
393
- * Account secret key used to authenticate requests.
394
- * @visibility secret
395
- */
396
- secretAccessKey?: string;
397
-
398
- /**
399
- * ARN of the role to be assumed
400
- */
401
- roleArn?: string;
402
-
403
- /**
404
- * External ID to use when assuming role
405
- */
406
- externalId?: string;
407
- }>;
408
-
409
- /** Integration configuration for Gitea */
410
- gitea?: Array<{
411
- /**
412
- * The hostname of the given Gitea instance
413
- * @visibility frontend
414
- */
415
- host: string;
416
- /**
417
- * The base url for the Gitea instance.
418
- * @visibility frontend
419
- */
420
- baseUrl?: string;
421
-
422
- /**
423
- * The username to use for authenticated requests.
424
- * @visibility secret
425
- */
426
- username?: string;
427
- /**
428
- * Gitea password used to authenticate requests. This can be either a password
429
- * or a generated access token.
430
- * @visibility secret
431
- */
432
- password?: string;
433
- /**
434
- * PGP signing key for signing commits.
435
- * @visibility secret
436
- */
437
- commitSigningKey?: string;
438
- }>;
439
- /** Integration configuration for Harness Code */
440
- harness?: Array<{
441
- /**
442
- * The hostname of the given Harness Code instance
443
- * @visibility frontend
444
- */
445
- host: string;
446
- /**
447
- * The apikey to use for authenticated requests.
448
- * @visibility secret
449
- */
450
- apiKey?: string;
451
- /**
452
- * Harness Code token used to authenticate requests. This can be either a generated access token.
453
- * @visibility secret
454
- */
455
- token?: string;
456
- }>;
457
- };
458
- }