ジャンプ先

• リクエスト
• レスポンス
• 例

新しいOAuthクライアントの追加

投稿

/oam/services/rest/ssa/api/v1/oauthpolicyadmin/client

リクエスト

サポートされているメディア・タイプ

• application/json

本文()

作成する必要があるOAuthクライアント

ルート・スキーマ: Client

型: object

ソースを表示

• accessTokenCustomClaims(optional): array accessTokenCustomClaims
• attributes(optional): array attributes
• clientType(optional): string
  指定可能な値: [ "CONFIDENTIAL_CLIENT", "PUBLIC_CLIENT", "MOBILE_CLIENT" ]

  クライアントのタイプ
• defaultScope(optional): string
  トークンで返されるデフォルトのスコープである必須スコープ
• description(optional): string
• grantTypes(optional): array grantTypes
• id(optional): string
  クライアントのClientID。指定されていない場合、自動生成されます
• idDomain(optional): string
  クライアントが存在するアイデンティティ・ドメインの名前
• idTokenCustomClaims(optional): array idTokenCustomClaims
• issueTLSClientCertificateBoundAccessTokens(optional): string
  トークンを証明書にバインドするかどうか(true/false)
• name: string
  クライアントの名前
• redirectURIs(optional): array redirectURIs
• scopes(optional): array scopes
• secret(optional): string
  機密である場合のクライアントのパスワード
• tlsClientAuthSANDNS(optional): string
  クライアントに対して照合される証明書SAN DNS値。
• tlsClientAuthSANEmail(optional): string
  クライアントに対して照合される証明書SAN電子メール値。
• tlsClientAuthSANIP(optional): string
  クライアントに対して照合される証明書SAN IP値。
• tlsClientAuthSANURI(optional): string
  クライアントに対して照合される証明書SAN URI値。
• tlsClientAuthSubjectDN(optional): string
  クライアントに対して照合される証明書サブジェクト値。
• tokenEndpointAuthMethod(optional): string
  指定可能な値: [ "tls_client_auth", "self_signed_tls_client_auth", "private_key_jwt", "client_secret_basic" ]

  クライアントでサポートされているクライアント認証方式。"tls_client_auth"または"self_signed_tls_client_auth"が指定されている場合、"tlsClientAuthSubjectDN"、"tlsClientAuthSANDNS"、"tlsClientAuthSANURI"、"tlsClientAuthSANIP"、"tlsClientAuthSANIP"、"tlsClientAuthSANEmail"のいずれかのプロパティが必要です。
• usePKCE(optional): string
  指定可能な値: [ "NON_STRICT", "STRICT" ]

  このクライアントに対してPKCEを有効にするオプション・パラメータ。指定しない場合、デフォルトはnullになります。
• userInfoCustomClaims(optional): array userInfoCustomClaims

{
    "type":"object",
    "required":[
        "name"
    ],
    "properties":{
        "name":{
            "type":"string",
            "description":"Name of the Client"
        },
        "description":{
            "type":"string"
        },
        "idDomain":{
            "type":"string",
            "description":"Name of the Identity Domain under which the Client exists"
        },
        "id":{
            "type":"string",
            "description":"ClientID for the client. Will be auto generated if not specified"
        },
        "secret":{
            "type":"string",
            "description":"Password for the client if confidential"
        },
        "clientType":{
            "type":"string",
            "description":"Type of the client",
            "enum":[
                "CONFIDENTIAL_CLIENT",
                "PUBLIC_CLIENT",
                "MOBILE_CLIENT"
            ]
        },
        "grantTypes":{
            "type":"array",
            "xml":{
                "name":"grantTypes",
                "wrapped":true
            },
            "items":{
                "type":"string",
                "enum":[
                    "PASSWORD",
                    "REFRESH_TOKEN",
                    "JWT_BEARER",
                    "CLIENT_CREDENTIALS",
                    "AUTHORIZATION_CODE"
                ]
            }
        },
        "scopes":{
            "type":"array",
            "xml":{
                "name":"scopes",
                "wrapped":true
            },
            "items":{
                "$ref":"#/definitions/ScopeSettings"
            }
        },
        "usePKCE":{
            "type":"string",
            "description":"Optional parameter to enable PKCE for this client. If not specified, default will be null.",
            "enum":[
                "NON_STRICT",
                "STRICT"
            ]
        },
        "defaultScope":{
            "type":"string",
            "description":"Mandatory scope which is the default scope returned in the token"
        },
        "redirectURIs":{
            "type":"array",
            "xml":{
                "name":"redirectURIs",
                "wrapped":true
            },
            "items":{
                "$ref":"#/definitions/RedirectURI"
            }
        },
        "attributes":{
            "type":"array",
            "xml":{
                "name":"attributes",
                "wrapped":true
            },
            "items":{
                "$ref":"#/definitions/TokenAttributeSettings"
            }
        },
        "tokenEndpointAuthMethod":{
            "type":"string",
            "description":"Client Authentication method supported by the client. If \"tls_client_auth\" or  \"self_signed_tls_client_auth\" is specified then one of the \"tlsClientAuthSubjectDN\",\"tlsClientAuthSANDNS\",\"tlsClientAuthSANURI\",\"tlsClientAuthSANIP\",\"tlsClientAuthSANIP\",\"tlsClientAuthSANEmail\" property is required.",
            "enum":[
                "tls_client_auth",
                "self_signed_tls_client_auth",
                "private_key_jwt",
                "client_secret_basic"
            ]
        },
        "issueTLSClientCertificateBoundAccessTokens":{
            "type":"string",
            "description":"Tokens should be bound to certificate or not true/false"
        },
        "tlsClientAuthSubjectDN":{
            "type":"string",
            "description":"Certificate subject value to be matched  for the client."
        },
        "tlsClientAuthSANDNS":{
            "type":"string",
            "description":"Certificate SAN DNS value to be matched  for the client."
        },
        "tlsClientAuthSANURI":{
            "type":"string",
            "description":"Certificate SAN URI value to be matched  for the client."
        },
        "tlsClientAuthSANIP":{
            "type":"string",
            "description":"Certificate SAN IP value to be matched  for the client."
        },
        "tlsClientAuthSANEmail":{
            "type":"string",
            "description":"Certificate SAN email value to be matched  for the client."
        },
        "accessTokenCustomClaims":{
            "type":"array",
            "items":{
                "type":"string",
                "description":"Represents a list of claims that must be included in the Access Token in addition to other claims that are being requested via scope or other configurations"
            }
        },
        "idTokenCustomClaims":{
            "type":"array",
            "items":{
                "type":"string",
                "description":"Represents a list of claims that must be included in the Identity Token in addition to other claims that are being requested via scope or other configurations"
            }
        },
        "userInfoCustomClaims":{
            "type":"array",
            "items":{
                "type":"string",
                "description":"Represents a list of claims that must be included in the User Info response in addition to other claims that are being requested via scope or other configurations"
            }
        }
    }
}

ネストされたスキーマ: accessTokenCustomClaims

型: array

ソースを表示

• 配列: 文字列
  スコープまたは他の構成を介してリクエストされている他のクレームに加えて、アクセス・トークンに含める必要があるクレームのリストを表します

{
    "type":"array",
    "items":{
        "type":"string",
        "description":"Represents a list of claims that must be included in the Access Token in addition to other claims that are being requested via scope or other configurations"
    }
}

ネストされたスキーマ: attributes

型: array

ソースを表示

• 配列: オブジェクト TokenAttributeSettings
  アクセス・トークンに追加できるカスタム属性

{
    "type":"array",
    "xml":{
        "name":"attributes",
        "wrapped":true
    },
    "items":{
        "$ref":"#/definitions/TokenAttributeSettings"
    }
}

ネストされたスキーマ: grantTypes

型: array

ソースを表示

• 配列: 文字列
  指定可能な値: [ "PASSWORD", "REFRESH_TOKEN", "JWT_BEARER", "CLIENT_CREDENTIALS", "AUTHORIZATION_CODE" ]

{
    "type":"array",
    "xml":{
        "name":"grantTypes",
        "wrapped":true
    },
    "items":{
        "type":"string",
        "enum":[
            "PASSWORD",
            "REFRESH_TOKEN",
            "JWT_BEARER",
            "CLIENT_CREDENTIALS",
            "AUTHORIZATION_CODE"
        ]
    }
}

ネストされたスキーマ: idTokenCustomClaims

型: array

ソースを表示

• 配列: 文字列
  スコープまたは他の構成を介してリクエストされている他のクレームに加えて、アイデンティティ・トークンに含める必要があるクレームのリストを表します

{
    "type":"array",
    "items":{
        "type":"string",
        "description":"Represents a list of claims that must be included in the Identity Token in addition to other claims that are being requested via scope or other configurations"
    }
}

ネストされたスキーマ: redirectURIs

型: array

ソースを表示

• 配列: オブジェクト RedirectURI

{
    "type":"array",
    "xml":{
        "name":"redirectURIs",
        "wrapped":true
    },
    "items":{
        "$ref":"#/definitions/RedirectURI"
    }
}

ネストされたスキーマ: scopes

型: array

ソースを表示

• 配列: オブジェクト ScopeSettings

{
    "type":"array",
    "xml":{
        "name":"scopes",
        "wrapped":true
    },
    "items":{
        "$ref":"#/definitions/ScopeSettings"
    }
}

ネストされたスキーマ: userInfoCustomClaims

型: array

ソースを表示

• 配列: 文字列
  スコープまたは他の構成を介してリクエストされている他のクレームに加えて、ユーザー情報レスポンスに含める必要があるクレームのリストを表します

{
    "type":"array",
    "items":{
        "type":"string",
        "description":"Represents a list of claims that must be included in the User Info response in addition to other claims that are being requested via scope or other configurations"
    }
}

ネストされたスキーマ: TokenAttributeSettings

型: object

アクセス・トークンに追加できるカスタム属性

ソースを表示

• attrName: string
  カスタム属性の名前
• attrType: string
  指定可能な値: [ "STATIC", "DYNAMIC" ]

  属性のタイプ
• attrValue: string
  カスタム属性の値。これは評価および置換される静的値または動的値になる可能性があります。

{
    "type":"object",
    "description":"Custom attributes that can be added to the Access Token",
    "required":[
        "attrName",
        "attrValue",
        "attrType"
    ],
    "properties":{
        "attrName":{
            "type":"string",
            "description":"Name of the custom attribute"
        },
        "attrValue":{
            "type":"string",
            "description":"Value of the custom attribute. This could be a static value or a dynamic one that is evaluated and substituted."
        },
        "attrType":{
            "type":"string",
            "description":"Type of the Attribute",
            "enum":[
                "STATIC",
                "DYNAMIC"
            ]
        }
    }
}

ネストされたスキーマ: RedirectURI

型: object

ソースを表示

• isHttps(optional): boolean
  デフォルト値: true
• url: string
  リダイレクトURL

{
    "type":"object",
    "required":[
        "url"
    ],
    "properties":{
        "url":{
            "type":"string",
            "description":"Redirect URL"
        },
        "isHttps":{
            "type":"boolean",
            "default":"true"
        }
    }
}

ネストされたスキーマ: ScopeSettings

型: object

ソースを表示

• scopeName: string
  スコープの名前

{
    "type":"object",
    "required":[
        "scopeName"
    ],
    "properties":{
        "scopeName":{
            "type":"string",
            "description":"Name of the scope"
        }
    }
}

先頭に戻る

レスポンス

サポートされているメディア・タイプ

• application/json

200 レスポンス

エンティティ - OAuthClient、詳細を正常に作成しました

本文()

ルート・スキーマ: Client

型: object

ソースを表示

• accessTokenCustomClaims(optional): array accessTokenCustomClaims
• attributes(optional): array attributes
• clientType(optional): string
  指定可能な値: [ "CONFIDENTIAL_CLIENT", "PUBLIC_CLIENT", "MOBILE_CLIENT" ]

  クライアントのタイプ
• defaultScope(optional): string
  トークンで返されるデフォルトのスコープである必須スコープ
• description(optional): string
• grantTypes(optional): array grantTypes
• id(optional): string
  クライアントのClientID。指定されていない場合、自動生成されます
• idDomain(optional): string
  クライアントが存在するアイデンティティ・ドメインの名前
• idTokenCustomClaims(optional): array idTokenCustomClaims
• issueTLSClientCertificateBoundAccessTokens(optional): string
  トークンを証明書にバインドするかどうか(true/false)
• name: string
  クライアントの名前
• redirectURIs(optional): array redirectURIs
• scopes(optional): array scopes
• secret(optional): string
  機密である場合のクライアントのパスワード
• tlsClientAuthSANDNS(optional): string
  クライアントに対して照合される証明書SAN DNS値。
• tlsClientAuthSANEmail(optional): string
  クライアントに対して照合される証明書SAN電子メール値。
• tlsClientAuthSANIP(optional): string
  クライアントに対して照合される証明書SAN IP値。
• tlsClientAuthSANURI(optional): string
  クライアントに対して照合される証明書SAN URI値。
• tlsClientAuthSubjectDN(optional): string
  クライアントに対して照合される証明書サブジェクト値。
• tokenEndpointAuthMethod(optional): string
  指定可能な値: [ "tls_client_auth", "self_signed_tls_client_auth", "private_key_jwt", "client_secret_basic" ]

  クライアントでサポートされているクライアント認証方式。"tls_client_auth"または"self_signed_tls_client_auth"が指定されている場合、"tlsClientAuthSubjectDN"、"tlsClientAuthSANDNS"、"tlsClientAuthSANURI"、"tlsClientAuthSANIP"、"tlsClientAuthSANIP"、"tlsClientAuthSANEmail"のいずれかのプロパティが必要です。
• usePKCE(optional): string
  指定可能な値: [ "NON_STRICT", "STRICT" ]

  このクライアントに対してPKCEを有効にするオプション・パラメータ。指定しない場合、デフォルトはnullになります。
• userInfoCustomClaims(optional): array userInfoCustomClaims

{
    "type":"object",
    "required":[
        "name"
    ],
    "properties":{
        "name":{
            "type":"string",
            "description":"Name of the Client"
        },
        "description":{
            "type":"string"
        },
        "idDomain":{
            "type":"string",
            "description":"Name of the Identity Domain under which the Client exists"
        },
        "id":{
            "type":"string",
            "description":"ClientID for the client. Will be auto generated if not specified"
        },
        "secret":{
            "type":"string",
            "description":"Password for the client if confidential"
        },
        "clientType":{
            "type":"string",
            "description":"Type of the client",
            "enum":[
                "CONFIDENTIAL_CLIENT",
                "PUBLIC_CLIENT",
                "MOBILE_CLIENT"
            ]
        },
        "grantTypes":{
            "type":"array",
            "xml":{
                "name":"grantTypes",
                "wrapped":true
            },
            "items":{
                "type":"string",
                "enum":[
                    "PASSWORD",
                    "REFRESH_TOKEN",
                    "JWT_BEARER",
                    "CLIENT_CREDENTIALS",
                    "AUTHORIZATION_CODE"
                ]
            }
        },
        "scopes":{
            "type":"array",
            "xml":{
                "name":"scopes",
                "wrapped":true
            },
            "items":{
                "$ref":"#/definitions/ScopeSettings"
            }
        },
        "usePKCE":{
            "type":"string",
            "description":"Optional parameter to enable PKCE for this client. If not specified, default will be null.",
            "enum":[
                "NON_STRICT",
                "STRICT"
            ]
        },
        "defaultScope":{
            "type":"string",
            "description":"Mandatory scope which is the default scope returned in the token"
        },
        "redirectURIs":{
            "type":"array",
            "xml":{
                "name":"redirectURIs",
                "wrapped":true
            },
            "items":{
                "$ref":"#/definitions/RedirectURI"
            }
        },
        "attributes":{
            "type":"array",
            "xml":{
                "name":"attributes",
                "wrapped":true
            },
            "items":{
                "$ref":"#/definitions/TokenAttributeSettings"
            }
        },
        "tokenEndpointAuthMethod":{
            "type":"string",
            "description":"Client Authentication method supported by the client. If \"tls_client_auth\" or  \"self_signed_tls_client_auth\" is specified then one of the \"tlsClientAuthSubjectDN\",\"tlsClientAuthSANDNS\",\"tlsClientAuthSANURI\",\"tlsClientAuthSANIP\",\"tlsClientAuthSANIP\",\"tlsClientAuthSANEmail\" property is required.",
            "enum":[
                "tls_client_auth",
                "self_signed_tls_client_auth",
                "private_key_jwt",
                "client_secret_basic"
            ]
        },
        "issueTLSClientCertificateBoundAccessTokens":{
            "type":"string",
            "description":"Tokens should be bound to certificate or not true/false"
        },
        "tlsClientAuthSubjectDN":{
            "type":"string",
            "description":"Certificate subject value to be matched  for the client."
        },
        "tlsClientAuthSANDNS":{
            "type":"string",
            "description":"Certificate SAN DNS value to be matched  for the client."
        },
        "tlsClientAuthSANURI":{
            "type":"string",
            "description":"Certificate SAN URI value to be matched  for the client."
        },
        "tlsClientAuthSANIP":{
            "type":"string",
            "description":"Certificate SAN IP value to be matched  for the client."
        },
        "tlsClientAuthSANEmail":{
            "type":"string",
            "description":"Certificate SAN email value to be matched  for the client."
        },
        "accessTokenCustomClaims":{
            "type":"array",
            "items":{
                "type":"string",
                "description":"Represents a list of claims that must be included in the Access Token in addition to other claims that are being requested via scope or other configurations"
            }
        },
        "idTokenCustomClaims":{
            "type":"array",
            "items":{
                "type":"string",
                "description":"Represents a list of claims that must be included in the Identity Token in addition to other claims that are being requested via scope or other configurations"
            }
        },
        "userInfoCustomClaims":{
            "type":"array",
            "items":{
                "type":"string",
                "description":"Represents a list of claims that must be included in the User Info response in addition to other claims that are being requested via scope or other configurations"
            }
        }
    }
}

ネストされたスキーマ: accessTokenCustomClaims

型: array

ソースを表示

• 配列: 文字列
  スコープまたは他の構成を介してリクエストされている他のクレームに加えて、アクセス・トークンに含める必要があるクレームのリストを表します

{
    "type":"array",
    "items":{
        "type":"string",
        "description":"Represents a list of claims that must be included in the Access Token in addition to other claims that are being requested via scope or other configurations"
    }
}

ネストされたスキーマ: attributes

型: array

ソースを表示

• 配列: オブジェクト TokenAttributeSettings
  アクセス・トークンに追加できるカスタム属性

{
    "type":"array",
    "xml":{
        "name":"attributes",
        "wrapped":true
    },
    "items":{
        "$ref":"#/definitions/TokenAttributeSettings"
    }
}

ネストされたスキーマ: grantTypes

型: array

ソースを表示

• 配列: 文字列
  指定可能な値: [ "PASSWORD", "REFRESH_TOKEN", "JWT_BEARER", "CLIENT_CREDENTIALS", "AUTHORIZATION_CODE" ]

{
    "type":"array",
    "xml":{
        "name":"grantTypes",
        "wrapped":true
    },
    "items":{
        "type":"string",
        "enum":[
            "PASSWORD",
            "REFRESH_TOKEN",
            "JWT_BEARER",
            "CLIENT_CREDENTIALS",
            "AUTHORIZATION_CODE"
        ]
    }
}

ネストされたスキーマ: idTokenCustomClaims

型: array

ソースを表示

• 配列: 文字列
  スコープまたは他の構成を介してリクエストされている他のクレームに加えて、アイデンティティ・トークンに含める必要があるクレームのリストを表します

{
    "type":"array",
    "items":{
        "type":"string",
        "description":"Represents a list of claims that must be included in the Identity Token in addition to other claims that are being requested via scope or other configurations"
    }
}

ネストされたスキーマ: redirectURIs

型: array

ソースを表示

• 配列: オブジェクト RedirectURI

{
    "type":"array",
    "xml":{
        "name":"redirectURIs",
        "wrapped":true
    },
    "items":{
        "$ref":"#/definitions/RedirectURI"
    }
}

ネストされたスキーマ: scopes

型: array

ソースを表示

• 配列: オブジェクト ScopeSettings

{
    "type":"array",
    "xml":{
        "name":"scopes",
        "wrapped":true
    },
    "items":{
        "$ref":"#/definitions/ScopeSettings"
    }
}

ネストされたスキーマ: userInfoCustomClaims

型: array

ソースを表示

• 配列: 文字列
  スコープまたは他の構成を介してリクエストされている他のクレームに加えて、ユーザー情報レスポンスに含める必要があるクレームのリストを表します

{
    "type":"array",
    "items":{
        "type":"string",
        "description":"Represents a list of claims that must be included in the User Info response in addition to other claims that are being requested via scope or other configurations"
    }
}

ネストされたスキーマ: TokenAttributeSettings

型: object

アクセス・トークンに追加できるカスタム属性

ソースを表示

• attrName: string
  カスタム属性の名前
• attrType: string
  指定可能な値: [ "STATIC", "DYNAMIC" ]

  属性のタイプ
• attrValue: string
  カスタム属性の値。これは評価および置換される静的値または動的値になる可能性があります。

{
    "type":"object",
    "description":"Custom attributes that can be added to the Access Token",
    "required":[
        "attrName",
        "attrValue",
        "attrType"
    ],
    "properties":{
        "attrName":{
            "type":"string",
            "description":"Name of the custom attribute"
        },
        "attrValue":{
            "type":"string",
            "description":"Value of the custom attribute. This could be a static value or a dynamic one that is evaluated and substituted."
        },
        "attrType":{
            "type":"string",
            "description":"Type of the Attribute",
            "enum":[
                "STATIC",
                "DYNAMIC"
            ]
        }
    }
}

ネストされたスキーマ: RedirectURI

型: object

ソースを表示

• isHttps(optional): boolean
  デフォルト値: true
• url: string
  リダイレクトURL

{
    "type":"object",
    "required":[
        "url"
    ],
    "properties":{
        "url":{
            "type":"string",
            "description":"Redirect URL"
        },
        "isHttps":{
            "type":"boolean",
            "default":"true"
        }
    }
}

ネストされたスキーマ: ScopeSettings

型: object

ソースを表示

• scopeName: string
  スコープの名前

{
    "type":"object",
    "required":[
        "scopeName"
    ],
    "properties":{
        "scopeName":{
            "type":"string",
            "description":"Name of the scope"
        }
    }
}

422 レスポンス

OAuthエンティティ"Client" - 名前"NameofClient"の作成に失敗しました

先頭に戻る

例

この例は、新しいクライアントを作成するサーバーに対するサンプル・リクエストを示します。

cURLの例

curl -i -H 'Content-Type: application/json' -H 'Authorization:Basic d2VibG9naWM6V2VsY29tZTE='
--request POST http:<AdminServerHost:Port>/oam/services/rest/ssa/api/v1/oauthpolicyadmin/client -d 
{"attributes":[{"attrName":"customeAttr1","attrValue":"CustomValue","attrType":"static"}],"secret":"welcome1","id":"TestClient","scopes":["ResServer1.scope1"],"clientType":"CONFIDENTIAL_CLIENT","idDomain":"TestDomain1",
"description":"Client Description","name":"TestClient","grantTypes":["PASSWORD","CLIENT_CREDENTIALS","JWT_BEARER","REFRESH_TOKEN","AUTHORIZATION_CODE"],"defaultScope":"ResServer1.scope1","redirectURIs":[{"url":"http://localhost:8080/Sample.jsp","isHttps":true}]}

リクエスト本文の例

次の例は、JSON形式の新しいクライアントを作成するレスポンス本文のコンテンツを示します。

HTTP/1.1 200 OK
Date: Thu, 27 Jul 2017 17:30:16 GMT
Content-Length: 27
Content-Type: text/plain
X-ORACLE-DMS-ECID: 78d30c19-07b6-4ac2-a39b-f1cbd8182ebb-0000012d
X-ORACLE-DMS-RID: 0
Set-Cookie: JSESSIONID=4J2FGVVUN8MXI5vdemvJw3HFPHyraFXIDVRoRUZwc_7Uia_SOhG5!-1875566563; path=/; HttpOnly

Sucessfully created entity - OAuthClient, detail...

先頭に戻る