この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。
英語に切り替える

Credential Input

ログイン情報の入力。
ルート XML タグ
<credential>
ログイン情報を作成する JSON の例 (POST)
1{
2externalCredential: "ecNameAws",
3authenticationProtocol: "AwsSv4",
4principalName: "principalA",
5principalType: "NamedPrincipal",
6credentials: {
7   awsAccessKeyId: {
8      value: "00000000000",
9      encrypted: false
10   },
11   awsSecretAccessKey: {
12      value: "aws-secret-value",
13      encrypted: true
14   },
15   awsRoleArn: {
16      value: "arn:partition:service:region:account-id:resource-id",
17      encrypted: false
18   }
19}
20}
ログイン情報を置換する JSON の例 (PUT)
この例では、ログイン情報に apiKeyapiSecret の 2 つの値があると仮定します。このリクエストボディが PUT で使用されると、apiKey が更新され、apiSecret が削除されます。
1{
2   authenticationProtocol: String : "Custom",
3   externalCredential: String : "medicalIntegrationExternalCredential",
4   principalName: String : "customerSupportGroup", 
5   principalType: String : "NamedPrincipal",
6   // Map<String, ConnectApi.CredentialValue>
7   credentials: { 
8       apiKey: { 
9           value: String : "00000000",
10           encrypted: Boolean : false
11       }
12   }
13}
カスタムログイン情報を更新する JSON の例 (PATCH)
PATCH はカスタムログイン情報でのみサポートされます。リクエストボディに含まれるログイン情報のみが更新されます。この例では、ログイン情報に apiKeyapiSecret の 2 つの値があると仮定します。このリクエストボディが PATCH で使用されると、apiKey が更新され、apiSecret はそのままになります。
1{
2   authenticationProtocol: String : "Custom",
3   externalCredential: String : "medicalIntegrationExternalCredential",
4   principalName: String : "customerSupportGroup", 
5   principalType: String : "NamedPrincipal",
6   // Map<String, ConnectApi.CredentialValue>
7   credentials: { 
8       apiKey: { 
9           value: String : "00000000",
10           encrypted: Boolean : false
11       }
12   }
13}
プロパティ
名前 説明 必須か省略可能 使用可能なバージョン
authentication​Protocol String 外部ログイン情報の認証プロトコル。値は次のとおりです。
  • AwsSv4
  • Custom
  • Jwt
  • OAuth
必須 56.0
authentication​ProtocolVariant String 外部ログイン情報の認証プロトコルバリエーション。値は次のとおりです。
  • AwsSv4_STS — セキュリティトークンサービスを使用する AWS 署名バージョン 4。
  • ClientCredentialsClientSecret — OAuth 2.0 クライアントログイン情報のクライアントの秘密。
  • ClientCredentialsJwtAssertion — OAuth 2.0 クライアントログイン情報の JSON Web トークンアサーション。
  • JwtBearer — OAuth 2.0 JSON Web トークンフロー。
  • NoAuthentication — 認証なし。
  • RolesAnywhere — Identity and Access Management (IAM) Roles Anywhere を使用する AWS 署名バージョン 4。
指定する場合は、認証プロトコルのバリエーションが実際の外部ログイン情報の認証プロトコルバリエーションと一致している必要があります。
省略可能 57.0
credentials Map<String, Credential Value Input> プロトコル固有のログイン情報の対応付け。
認証プロトコルには、ログイン情報の許可リストと暗号化ルールがあります。
  • AwsSv4awsAccessKeyId (暗号化なし)、awsSecretAccessKey (暗号化あり)、awsRoleArn (暗号化なし)
  • Custom — 任意のログイン情報の名前が有効 (ユーザが暗号化ルールを設定)
必須 56.0
externalCredential String 外部ログイン情報の完全修飾開発者名。 必須 56.0
principalName String 外部ログイン情報の指定ユーザの名前。 principalTypeNamedPrincipal の場合は必須 56.0
principalType String ログイン情報プリンシパルの種別。値は次のとおりです。
  • AwsStsPrincipal
  • NamedPrincipal
  • PerUserPrincipal
必須 56.0