フェデレーションルールを作成
POST/v1/organizations/federation_rules
org:adminスコープを持つOAuthアクセストークンが必要です。このトークンはant auth login --scope org:adminまたはワークロードアイデンティティフェデレーションルールから取得します。Admin APIキーは受け付けられません。Admin APIでWIFを管理するを参照してください。
組織が所有するフェデレーションルールを作成します。
参照される発行者と対象のサービスアカウントは、同じ組織内にすでに存在している必要があります。
無効な参照は400エラーで拒否されます。ワークスペースの参照は検証されます。
ルール作成時にメンバーシップはチェックされません。トークン交換は呼び出しごとに有効な
ワークスペースを1つ解決し、対象のサービスアカウントがそのワークスペースのメンバーでない限り
拒否されます（デフォルトワークスペースには暗黙的にメンバーとなっています）。
よく知られた共有発行者（GitHub Actions、GitLab、Buildkite、Terraform Cloud、Google）に対する
ルールは、アイデンティティを含むクレーム、テナントを固定するサブジェクトプレフィックス
（repo:YOUR_ORG/...など）、またはそれらのアイデンティティクレームのいずれかを参照する
CEL条件（例：claims.repository_owner）によって、テナントのアイデンティティを制約する必要があります。
OAuth呼び出し元が管理できるのは、oauth_scopeがworkspace:developerまたは
workspace:inferenceであるルールのみです。その他のスコープにはConsoleセッションが必要です。
Parameters
Returns
フェデレーションルールを作成
import os
from anthropic import Anthropic
client = Anthropic(
api_key=os.environ.get(
"ANTHROPIC_API_KEY"
), # This is the default and can be omitted
)
beta_federation_rule = client.beta.organization.federation.rules.create(
issuer_id="issuer_id",
match={},
name="x",
oauth_scope="x",
target={
"service_account_id": "svac_01SDCCSbTxrXDpWc1phhtcfK",
"type": "service_account",
},
)
print(beta_federation_rule.id)Response 200
{
"id": "fdrl_01SDCCSbTxrXDpWc1phhtcfK",
"applies_to_all_workspaces": true,
"archived_at": "2019-12-27T18:11:19.117Z",
"archived_by_actor_id": "archived_by_actor_id",
"attributes": {
"foo": "string"
},
"created_at": "2024-10-30T23:58:27.427722Z",
"created_by_actor_id": "created_by_actor_id",
"description": "description",
"issuer_id": "issuer_id",
"issuer_name": "issuer_name",
"match": {
"audience": "audience",
"claims": {
"foo": "string"
},
"condition": "condition",
"subject_prefix": "subject_prefix"
},
"name": "prod-deploy-pipeline",
"oauth_scope": "oauth_scope",
"target": {
"service_account_id": "svac_01SDCCSbTxrXDpWc1phhtcfK",
"type": "service_account",
"service_account_name": "service_account_name"
},
"token_lifetime_seconds": 0,
"type": "federation_rule",
"updated_at": "2024-10-30T23:58:27.427722Z",
"updated_by_actor_id": "updated_by_actor_id",
"workspace_id": "workspace_id",
"workspace_ids": [
"string"
]
}Returns Examples
Response 200
{
"id": "fdrl_01SDCCSbTxrXDpWc1phhtcfK",
"applies_to_all_workspaces": true,
"archived_at": "2019-12-27T18:11:19.117Z",
"archived_by_actor_id": "archived_by_actor_id",
"attributes": {
"foo": "string"
},
"created_at": "2024-10-30T23:58:27.427722Z",
"created_by_actor_id": "created_by_actor_id",
"description": "description",
"issuer_id": "issuer_id",
"issuer_name": "issuer_name",
"match": {
"audience": "audience",
"claims": {
"foo": "string"
},
"condition": "condition",
"subject_prefix": "subject_prefix"
},
"name": "prod-deploy-pipeline",
"oauth_scope": "oauth_scope",
"target": {
"service_account_id": "svac_01SDCCSbTxrXDpWc1phhtcfK",
"type": "service_account",
"service_account_name": "service_account_name"
},
"token_lifetime_seconds": 0,
"type": "federation_rule",
"updated_at": "2024-10-30T23:58:27.427722Z",
"updated_by_actor_id": "updated_by_actor_id",
"workspace_id": "workspace_id",
"workspace_ids": [
"string"
]
}