setup

Anthropic

Purpose

Collects organization, user, workspace, and API key data from the Anthropic Admin API to map AI infrastructure dependencies inside Subimage.

tip

Secret fields below accept either an AWS Secrets Manager ARN or a value pasted directly into Subimage's managed vault. See Secrets for details.

Choose how Subimage connects

Your organization Recommended connection What Subimage can do
Claude Enterprise Admin key scoped to read:members Read members only. The key can't change anything.
Claude Console Workload identity federation Sync with a short-lived token. Subimage stores no Anthropic credential, and you can revoke access at any time.
Claude Console Admin API key Sync with a stored key. This is the simplest setup, but Console admin keys have no scopes.

Claude Enterprise organizations have no workspaces or API keys, so Subimage syncs only the organization and its members.

Option 1: Claude Enterprise scoped admin key

  1. In Claude, go to Organization settings > API and create an admin key with only the read:members scope.
  2. In Subimage, enter the key in anthropic_apikey, or enter the ARN of an AWS Secrets Manager secret that holds it. Save the module.

Option 2: Workload identity federation

Each sync proves its identity with a token that your Subimage deployment signs. Anthropic exchanges that token for an access token that lasts at most an hour.

  1. In the Claude Console, go to Settings > Workload identity and click Register issuer. Set Issuer URL to <IDENTITY_ISSUER>, set JWKS source to OIDC discovery, and keep the other defaults.

    If you see placeholders instead of the issuer URL and the subject in the next step, open these docs from your Subimage app, or ask Subimage support for both values.

  2. Go to Settings > Service accounts and create a service account with the Admin organization role.

  3. Go back to Settings > Workload identity, open the Rules tab, and create a rule with these settings:

    Setting Value
    Issuer The issuer from step 1
    Subject pattern system:serviceaccount:subimage:subimage-sync
    Expected audience https://api.anthropic.com
    Service account The service account from step 2
    OAuth scope org:admin. The Admin API accepts no narrower scope.
    Token lifetime 1 hour. The default of 10 minutes can expire before a large sync finishes.
  4. In Subimage, leave anthropic_apikey empty and fill in these fields:

    Field Value
    anthropic_organization_id Your organization ID, from Settings > Organization in the Claude Console
    anthropic_federation_rule_id The federation rule ID, which starts with fdrl_
    anthropic_service_account_id The service account ID, which starts with svac_
    anthropic_workspace_id Optional. Set it only when the federation rule covers more than one workspace.
  5. Save the module.

If Anthropic refuses the token, the sync status shows the issuer and subject that the federation rule must trust. For the exact reason, open the Authentication events tab under Settings > Workload identity in the Claude Console.

To revoke access, disable the federation rule. The next sync fails, and there's no stored credential to rotate.

Option 3: Claude Console admin API key

  1. In the Claude Console, create an Admin API key.
  2. In Subimage, enter the key in anthropic_apikey, or enter the ARN of an AWS Secrets Manager secret that holds it. Save the module.