Oracle Access ManagerでのOAuth REST API

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

投稿

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

リクエスト

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

application/json

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

ルート・スキーマ: Client

型: object

ソースを表示

attributes: array attributes
clientType: string

指定可能な値: [ "CONFIDENTIAL_CLIENT", "PUBLIC_CLIENT", "MOBILE_CLIENT" ]

クライアントのタイプ
description: string
grantTypes: array grantTypes
id: string

クライアントのClientID。指定されていない場合、自動生成されます
idDomain: string

クライアントが存在するアイデンティティ・ドメインの名前
name: string

クライアントの名前
redirectURIs: array redirectURIs
scopes: array scopes
secret: string

機密である場合のクライアントのパスワード

{
    "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"
            }
        },
        "redirectURIs":{
            "type":"array",
            "xml":{
                "name":"redirectURIs",
                "wrapped":true
            },
            "items":{
                "$ref":"#/definitions/RedirectURI"
            }
        },
        "attributes":{
            "type":"array",
            "xml":{
                "name":"attributes",
                "wrapped":true
            },
            "items":{
                "$ref":"#/definitions/TokenAttributeSettings"
            }
        }
    }
}

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

型: array

ソースを表示

[0]: object TokenAttributeSettings

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

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

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

型: array

ソースを表示

[0]: string

指定可能な値: [ "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"
        ]
    }
}

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

型: array

ソースを表示

[0]: object RedirectURI

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

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

型: array

ソースを表示

[0]: object ScopeSettings

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

ネストされたスキーマ: 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: 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

ソースを表示

attributes: array attributes
clientType: string

指定可能な値: [ "CONFIDENTIAL_CLIENT", "PUBLIC_CLIENT", "MOBILE_CLIENT" ]

クライアントのタイプ
description: string
grantTypes: array grantTypes
id: string

クライアントのClientID。指定されていない場合、自動生成されます
idDomain: string

クライアントが存在するアイデンティティ・ドメインの名前
name: string

クライアントの名前
redirectURIs: array redirectURIs
scopes: array scopes
secret: string

機密である場合のクライアントのパスワード

{
    "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"
            }
        },
        "redirectURIs":{
            "type":"array",
            "xml":{
                "name":"redirectURIs",
                "wrapped":true
            },
            "items":{
                "$ref":"#/definitions/RedirectURI"
            }
        },
        "attributes":{
            "type":"array",
            "xml":{
                "name":"attributes",
                "wrapped":true
            },
            "items":{
                "$ref":"#/definitions/TokenAttributeSettings"
            }
        }
    }
}

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

型: array

ソースを表示

[0]: object TokenAttributeSettings

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

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

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

型: array

ソースを表示

[0]: string

指定可能な値: [ "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"
        ]
    }
}

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

型: array

ソースを表示

[0]: object RedirectURI

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

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

型: array

ソースを表示

[0]: object ScopeSettings

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

ネストされたスキーマ: 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: 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...