get
https://api.doppler.com/v3/integrations/integration
Retrieve an existing integration
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Federation
Integrations that authenticate keylessly return a federation object describing the identity Doppler presents to your cloud. It is null for every other integration, including those of a keyless-capable type that were connected with a stored credential.
Grant this identity access in your cloud after creating the connection. Until you do, Doppler can authenticate but has no permissions, and the connection reports no error because a keyless connection's access isn't verified at create time.
GCP
| Field | Type | Description |
|---|---|---|
| kind | string | Always gcp. |
| principal | string | The IAM principal to grant roles to, beginning with principal://iam.googleapis.com/. |
{
"integration": {
"slug": "00000000-0000-0000-0000-000000000000",
"name": "my-integration",
"type": "gcp_secret_manager",
"federation": {
"kind": "gcp",
"principal": "principal://iam.googleapis.com/projects/123456789012/locations/global/workloadIdentityPools/doppler/subject/workplace:my-workplace:connection:00000000-0000-0000-0000-000000000000"
}
}
}Azure
| Field | Type | Description |
|---|---|---|
| kind | string | Always azure. |
| issuer | string | The issuer to enter on the app registration's federated credential. |
| subject | string | The subject identifier to enter on the federated credential. |
| audience | string | The audience to enter on the federated credential. |
{
"integration": {
"slug": "00000000-0000-0000-0000-000000000000",
"name": "my-integration",
"type": "azure_rotated_service_principal",
"federation": {
"kind": "azure",
"issuer": "https://api.doppler.com",
"subject": "workplace:my-workplace:connection:00000000-0000-0000-0000-000000000000",
"audience": "api://AzureADTokenExchange"
}
}
}