プライマリ・コンテンツに移動
Oracle® Fusion Middleware Oracle Web Services Managerでの資格証明およびキーストアの管理のためのREST API
リリース12c 12.2.1.1
E79356-01
目次へ移動
目次
前
前 		次
次

6 トークン発行者の信頼構成の管理

REST APIを使用してトークン発行者の信頼構成の参照や管理を行うには、まず、RESTリソースにアクセスする方法と、その他の重要な概念について理解しておく必要があります。

詳細は、「REST APIについて」を参照してください。

トークン発行者の信頼の管理の詳細は、『Webサービスの管理』の署名証明書の信頼できる発行者および信頼できるDNリストの定義に関する項を参照してください。

この章の内容は次のとおりです。

RESTリソースを使用したトークン発行者の信頼構成の参照と管理

トークン発行者の信頼構成の参照と管理には、Representational State Transfer (REST)リソースのセットを使用できます。次に、その概要を示します。

参照先 メソッド リソース・パス

信頼ドキュメント名のPOSTメソッド

POST

/idaas/webservice/admin/v1/trustdocument

ドメインの信頼できる発行者と識別名リストのPOSTメソッド

POST

/idaas/webservice/admin/v1/trust/issuers

ドキュメントの信頼できる発行者と識別名リストのPOSTメソッド

POST

/idaas/webservice/admin/v1/trust/issuers

すべての信頼できる発行者と識別名リストのGETメソッド

GET

/idaas/webservice/admin/v1/trust/issuers

特定のドキュメントの信頼できる発行者と識別名リストのGETメソッド

GET

/idaas/webservice/admin/v1/trust/issuers

トークン属性ルール識別名のPOSTメソッド(ドメイン・コンテキスト)

POST

/idaas/webservice/admin/v1/trust/token

トークン属性ルール識別名のPOSTメソッド(ドキュメント・コンテキスト)

POST

/idaas/webservice/admin/v1/trust/token

すべてのトークン属性のGETメソッド

GET

/idaas/webservice/admin/v1/trust/token

指定したドキュメント・トークン属性ルールのGETメソッド

GET

/idaas/webservice/admin/v1/trust/token

信頼ドキュメント名の構成のインポート・メソッド

POST

/idaas/webservice/admin/v1/trustdocument/import

信頼ドキュメントのGETメソッド

GET

/idaas/webservice/admin/v1/trustdocument

信頼ドキュメントのDELETEメソッド

DELETE

/idaas/webservice/admin/v1/trustdocument

信頼ドキュメント名のPOSTメソッド

このPostメソッドは、信頼できる発行者ドキュメントを作成するために使用します。

RESTリクエスト

POST /idaas/webservice/admin/v1/trustdocument

パラメータ

次の表は、POSTリクエストのパラメータの概要を示します。

名前 説明 タイプ

"displayName"

ドキュメントの表示名。

問合せ

"documentName"

ドキュメントの名前。

問合せ

レスポンス本文

メディア・タイプ:

application/json

返されるレスポンス本文には、インポート操作に関する次のようなステータスが含まれます。

属性 説明

"ERROR_CODE"

"STATUS"が"Failed"に設定されている場合はエラー・コードが提供されます。

"ERROR_MSG"

"STATUS"が"Failed"に設定されている場合はエラー・メッセージの内容が提供されます。

"Result"

操作結果の詳細。

"STATUS"

操作のステータス。たとえば、"Succeeded"または"Failed"。

cURLの例

テスト済

次の例は、cURLを使用してRESTリソースにPOSTリクエストを発行して信頼できる発行者ドキュメントを作成する方法を示しています。

curl -i -X POST -u username:password  http://myhost:7001/idaas/webservice/admin/v1/trustdocument?"documentName=myTrustDocument&displayName=myTrustDocument"

レスポンス・ヘッダーの例

レスポンス・ヘッダーの例を次に示します。HTTPステータス・コードの詳細は、「HTTPメソッドのHTTPステータス・コード」を参照してください。

HTTP/1.1 200 OK

レスポンス本文の例

JSON形式のレスポンス本文の例を次に示します。

{
    "STATUS": "Succeeded",
    "Result": "New Token Issuer Trust document named "myTrustDocument" created."
}

ドメインの信頼できる発行者と識別名リストのPOSTメソッド

このPOSTメソッドは、ドメインのコンテキストにおける署名証明書(つまり、ドメイン全体に適用される署名証明書)の信頼できる発行者と識別名(DN)のリストを作成するために使用します。

RESTリクエスト

POST /idaas/webservice/admin/v1/trust/issuers

リクエスト本文

メディア・タイプ:

application/json

リクエスト本文には、追加リクエストの詳細が含まれます。

属性 説明 必須

"dn"

信頼できる発行者に追加されるDN値のリスト。各DNについて、RFC 2253に従った文字列を使用します(次のURLを参照: http://www.ietf.org/rfc/rfc2253.txt)。

はい

"issuer"

信頼できる発行者に関する情報をグループ化します。

はい

"-name"

信頼する発行者の名前。たとえば、www.yourcompany.com。事前定義のSAMLクライアント・ポリシーのデフォルト値はwww.oracle.comです。

はい

"jwt-trusted-dns"

JSON Web Token (JWT)の信頼できる発行者に関する情報をグループ化します。

いいえ

"saml-hok-trusted-dns"

SAML holder-of-keyの信頼できる発行者に関する情報をグループ化します。

いいえ

"saml-sv-trusted-dns"

SAML送信者保証の信頼できる発行者に関する情報をグループ化します。

いいえ

"saml-trusted-dns"

信頼できる発行者およびDNリストをグループ化します。

はい

レスポンス本文

メディア・タイプ:

application/json

返されるレスポンス本文には、インポート操作に関する次のようなステータスが含まれます。

属性 説明

"ERROR_CODE"

"STATUS"が"Failed"に設定されている場合はエラー・コードが提供されます。

"ERROR_MSG"

"STATUS"が"Failed"に設定されている場合はエラー・メッセージの内容が提供されます。

"STATUS"

操作のステータス。たとえば、"Succeeded"または"Failed"。

cURLの例

テスト済

次の例は、cURLを使用してRESTリソースにPOSTリクエストを発行して信頼できる発行者およびDNリストを作成する方法を示しています。

curl -i -X POST -u username:password --data @createtrust.json -H Content-Type:application/json http://myhost:7001/idaas/webservice/admin/v1/trust/issuers

リクエスト本文の例

JSON形式のリクエスト本文の例を次に示します。 

{ 
    "saml-trusted-dns": 
    { 
         "saml-hok-trusted-dns": 
         { 
             "issuer": [ 
             { 
                 "-name": "www.oracle.com", 
                 "dn": [ "wls1", ]
             } 
             ] 
         }, 
        "saml-sv-trusted-dns": 
        { 
            "issuer": [ 
                { 
                    "-name": "www.oracle.com", 
                    "dn": [ "wls2", ] 
                } 
           ] 
        }, 
        "jwt-trusted-issuers": 
        { 
            "issuer": [ 
            { 
                "-name": "www.oracle.com", 
                "dn": [ "CN=orakey, OU=Orakey,O=Oracle, C=US", ] 
            }
            ] 
        } 
    } 
}

レスポンス・ヘッダーの例

レスポンス・ヘッダーの例を次に示します。

HTTP/1.1 200 OK

レスポンス本文の例

JSON形式のレスポンス本文の例を次に示します。

{
    "STATUS": "Succeeded",
}

ドキュメントの信頼できる発行者と識別名リストのPOSTメソッド

このPOSTメソッドは、ドキュメントのコンテキストにおける署名証明書(つまり、特定のドキュメントに適用される署名証明書)の信頼できる発行者と識別名(DN)のリストを作成するために使用します。信頼できる発行者は、指定された信頼できる発行者ドキュメントに格納されます。

RESTリクエスト

POST /idaas/webservice/admin/v1/trust/issuers/{documentName}

パラメータ

次の表は、POSTリクエストのパラメータの概要を示します。

名前 説明 タイプ

documentName

信頼できる発行者ドキュメントの名前。信頼できる発行者ドキュメントの作成の詳細は、「信頼ドキュメント名のPOSTメソッド」を参照してください。

問合せ

リクエスト本文

メディア・タイプ:

application/json

リクエスト本文には、追加リクエストの詳細が含まれます。

属性 説明 必須

"dn"

信頼できる発行者に追加されるDN値のリスト。各DNについて、RFC 2253に従った文字列を使用します(次のURLを参照: http://www.ietf.org/rfc/rfc2253.txt)。

はい

"issuer"

信頼できる発行者に関する情報をグループ化します。

はい

"-name"

信頼する発行者の名前。たとえば、www.yourcompany.com。事前定義のSAMLクライアント・ポリシーのデフォルト値はwww.oracle.comです。

はい

"jwt-trusted-dns"

JSON Web Token (JWT)の信頼できる発行者に関する情報をグループ化します。

いいえ

"saml-hok-trusted-dns"

SAML holder-of-keyの信頼できる発行者に関する情報をグループ化します。

いいえ

"saml-sv-trusted-dns"

SAML送信者保証の信頼できる発行者に関する情報をグループ化します。

いいえ

"saml-trusted-dns"

信頼できる発行者およびDNリストをグループ化します。

はい

レスポンス本文

メディア・タイプ:

application/json

返されるレスポンス本文には、インポート操作に関する次のようなステータスが含まれます。

属性 説明

"ERROR_CODE"

"STATUS"が"Failed"に設定されている場合はエラー・コードが提供されます。

"ERROR_MSG"

"STATUS"が"Failed"に設定されている場合はエラー・メッセージの内容が提供されます。

"STATUS"

操作のステータス。たとえば、"Succeeded"または"Failed"。

cURLの例

テスト済

次の例は、cURLを使用してRESTリソースにPOSTリクエストを発行し、信頼できる発行者とDNリストを作成する方法を示しています

curl -i -X POST -u username:password --data @createtrust.json -H Content-Type:application/json http://myhost:7001/idaas/webservice/admin/v1/trust/issuers/mydocument

リクエスト本文の例

JSON形式のリクエスト本文の例を次に示します。 

{ 
    "saml-trusted-dns": 
    { 
         "saml-hok-trusted-dns": 
         { 
             "issuer": [ 
             { 
                 "-name": "www.oracle.com", 
                 "dn": [ "wls1", ]
             } 
             ] 
         }, 
        "saml-sv-trusted-dns": 
        { 
            "issuer": [ 
                { 
                    "-name": "www.oracle.com", 
                    "dn": [ "wls2", ] 
                } 
           ] 
        }, 
        "jwt-trusted-issuers": 
        { 
            "issuer": [ 
            { 
                "-name": "www.oracle.com", 
                "dn": [ "CN=orakey, OU=Orakey,O=Oracle, C=US", ] 
            }
            ] 
        } 
    } 
}

レスポンス・ヘッダーの例

レスポンス・ヘッダーの例を次に示します。

HTTP/1.1 200 OK

レスポンス本文の例

JSON形式のレスポンス本文の例を次に示します。

{
    "STATUS": "Succeeded",
}

すべての信頼できる発行者と識別名リストのGETメソッド

このGETメソッドは、すべてのドメイン・ドキュメントについて、信頼できる発行者と発行者の識別名(DN)リストを参照するために使用します。

RESTリクエスト

GET /idaas/webservice/admin/v1/trust/issuers

レスポンス本文

メディア・タイプ:

application/json

レスポンス本文には、信頼できる発行者およびDNリストに関する次のような情報が含まれます。

属性 説明

"dn"

信頼できる発行者に追加されるDN値のリスト。

"issuer"

信頼できる発行者に関する情報をグループ化します。

"-name"

信頼する発行者の名前。

"jwt-trusted-dns"

JSON Web Token (JWT)の信頼できる発行者に関する情報をグループ化します。

"saml-hok-trusted-dns"

SAML holder-of-keyの信頼できる発行者に関する情報をグループ化します。

"saml-sv-trusted-dns"

SAML送信者保証の信頼できる発行者に関する情報をグループ化します。

"saml-trusted-dns"

DNリストをグループ化します。

cURLの例

テスト済

次の例は、cURLを使用してRESTリソースにGETリクエストを発行して信頼できる発行者およびそのDNリストを参照する方法を示しています。

curl -i -X GET -u username:password http://myhost:7001/idaas/platform/admin/v1/trust/issuers

レスポンス・ヘッダーの例

レスポンス・ヘッダーの例を次に示します。

HTTP/1.1 200 OK

レスポンス本文の例

JSON形式のレスポンス本文の例を次に示します。

{ 
    "saml-trusted-dns": 
    { 
         "saml-hok-trusted-dns": 
         { 
             "issuer": [ 
             { 
                 "-name": "www.oracle.com", 
                 "dn": [ "wls1", ]
             } 
             ] 
         }, 
        "saml-sv-trusted-dns": 
        { 
            "issuer": [ 
                { 
                    "-name": "www.oracle.com", 
                    "dn": [ "wls2", ] 
                } 
           ] 
        }, 
        "jwt-trusted-issuers": 
        { 
            "issuer": [ 
            { 
                "-name": "www.oracle.com", 
                "dn": [ "CN=orakey, OU=Orakey,O=Oracle, C=US", ] 
            }
            ] 
        } 
    } 
}

特定のドキュメントの信頼できる発行者と識別名リストのGETメソッド

このGETメソッドは、指定されたドキュメント名に基づいて、信頼できる発行者と発行者の識別名(DN)リストを参照するために使用します。

RESTリクエスト

GET /idaas/webservice/admin/v1/trust/issuers/{documentName}

パラメータ

次の表は、GETリクエストのパラメータの概要を示します。

名前 説明 タイプ

documentName

発行者とDNリストを参照するドキュメントの名前。

パス

レスポンス本文

メディア・タイプ:

application/json

レスポンス本文には、信頼できる発行者およびDNリストに関する次のような情報が含まれます。

属性 説明

"dn"

信頼できる発行者に追加されるDN値のリスト。

"issuer"

信頼できる発行者に関する情報をグループ化します。

"-name"

信頼する発行者の名前。

"jwt-trusted-dns"

JSON Web Token (JWT)の信頼できる発行者に関する情報をグループ化します。

"saml-hok-trusted-dns"

SAML holder-of-keyの信頼できる発行者に関する情報をグループ化します。

"saml-sv-trusted-dns"

SAML送信者保証の信頼できる発行者に関する情報をグループ化します。

"saml-trusted-dns"

DNリストをグループ化します。

cURLの例

テスト済

次の例は、cURLを使用してRESTリソースにGETリクエストを発行して信頼できる発行者およびそのDNリストを参照する方法を示しています。

curl -i -X GET -u username:password http://myhost:7001/idaas/platform/admin/v1/trust/issuers/mydocument

レスポンス・ヘッダーの例

レスポンス・ヘッダーの例を次に示します。

HTTP/1.1 200 OK

レスポンス本文の例

JSON形式のレスポンス本文の例を次に示します。

{ 
    "saml-trusted-dns": 
    { 
         "saml-hok-trusted-dns": 
         { 
             "issuer": [ 
             { 
                 "-name": "www.oracle.com", 
                 "dn": [ "wls1", ]
             } 
             ] 
         }, 
        "saml-sv-trusted-dns": 
        { 
            "issuer": [ 
                { 
                    "-name": "www.oracle.com", 
                    "dn": [ "wls2", ] 
                } 
           ] 
        }, 
        "jwt-trusted-issuers": 
        { 
            "issuer": [ 
            { 
                "-name": "www.oracle.com", 
                "dn": [ "CN=orakey, OU=Orakey,O=Oracle, C=US", ] 
            }
            ] 
        } 
    } 
}

トークン属性ルール識別名のPOSTメソッド(ドメイン・コンテキスト)

このPOSTメソッドは、ドメインのコンテキストに対応する信頼できる識別名(DN)のトークン属性ルール(つまり、ドメイン全体に適用されるルール)を作成するために使用します。この操作は、RESTサービスまたはクライアントにより実行できます。クライアント側ではトークン属性のマッピングのみがサポートされます。

RESTリクエスト

POST /idaas/webservice/admin/v1/trust/token

リクエスト本文

メディア・タイプ:

application/json

リクエスト本文には、追加リクエストの詳細が含まれます。

属性 説明

"attributes"

信頼できるユーザーの制約フィルタおよびマッピングの属性をグループ化します。

注意: クライアント側では、この属性は必要ではありません。

"-dn"

サービス側では、属性ルールが構成される信頼できるDNに設定します。RFC 2253に従った文字列を使用します(次のURLを参照: http://www.ietf.org/rfc/rfc2253.txt)。

クライアント側では、http(s)://hostまたはhttp(s)://host/rootの形式を使用して、この値を、対象のサービスをホストしているドメインのURLに設定します。たとえば、この値をhttps://messaging.us2.com/に設定した場合、https://messaging.us2.com/<path>の形式のサービスURLを使用したサービスの起動すべてに属性ルールが適用されます。

"filter"

信頼できるユーザーの制約値および属性を定義します。

注意: この属性は、クライアント側では適用されません。

"mapping"

信頼できるユーザーのマッピング属性を定義します。

"-name"

属性ルールの名前。

注意: この属性は、クライアント側では適用されません。

"name-id"

信頼できるDNとして受け入れるユーザーを定義します。

"token-attribute-rule"

1つのトークン属性ルールに関する情報をグループ化します。

"tokn-attribute-rules"

すべてのトークン属性ルールに関する情報をグループ化します。

"user-attribute"

信頼できるDNがアサートできるユーザー属性を定義します。

注意: この属性は、クライアント側では適用されません。

"user-mapping-attribute"

信頼できるDNがアサートできるユーザー・マッピング属性を定義します。

"value"

制約フィルタの属性値を定義します。この値には、完全な名前またはワイルドカード文字(*)を含む名前パターン(yourTrusted*など)を使用できます。複数の値は、カンマで区切る必要があります。

注意: この属性は、クライアント側では適用されません。

レスポンス本文

メディア・タイプ:

application/json

返されるレスポンス本文には、インポート操作に関する次のようなステータスが含まれます。

属性 説明

"ERROR_CODE"

"STATUS"が"Failed"に設定されている場合はエラー・コードが提供されます。

"ERROR_MSG"

"STATUS"が"Failed"に設定されている場合はエラー・メッセージの内容が提供されます。

"STATUS"

操作のステータス。たとえば、"Succeeded"または"Failed"。

cURLの例

テスト済

次の例は、cURLを使用してRESTリソースにPOSTリクエストを発行して信頼できるDNのトークン属性ルールを作成する方法を示しています。

curl -i -X POST -u username:password --data @createrule.json http://myhost:7001/idaas/webservice/admin/v1/trust/token

リクエスト本文の例(サービス側)

次の例は、サービス側で信頼できるDNのトークン属性ルールを作成する場合のJSON形式のリクエスト本文です。

{
    "token-attribute-rules":
    {
        "token-attribute-rule": 
        [
            {
                "-dn": "cn=orcladmin,o=oracle",
                "name-id":{
                    "filter": 
                    {
                        "value":[ "filter1" ]
                    },
                    "mapping":
                    {
                        "user-attribute": "val3",
                        "user-mapping-attribute":"val4"
                    }
                },
                "attributes":
                [
                    {
                        "-name": "tenant1",
                        "attribute":
                        {
                            "filter":
                            {
                                "value": [
                                    "filter1",
                                    "filter2"
                                ]
                            },
                            "mapping":{
                                "user-attribute": "val1",
                                "user-mapping-attribute":"val2"
                            }
                        }
                    }
                ]
            }
        ]
    }
}

リクエスト本文の例(クライアント側)

次の例は、クライアント側でトークン属性ルールを作成する場合のJSON形式のリクエスト本文です。

{
    "token-attribute-rules":
    {
        "token-attribute-rule": 
        [
            {
                "-dn": "https://messaging.us2.com/",
                "name-id":{
                    "mapping":
                    {
                        "user-mapping-attribute":"mail"
                    }
                },
            }
        ]
        "token-attribute-rule": 
        [
            {
                "-dn": "https://messaging.us2.com/mysvcInstance1-acme/",
                "name-id":{
                    "mapping":
                    {
                        "user-mapping-attribute":"uid"
                    }
                },
            }
        ]
    }
}

レスポンス・ヘッダーの例

レスポンス・ヘッダーの例を次に示します。

HTTP/1.1 200 OK

レスポンス本文の例

JSON形式のレスポンス本文の例を次に示します。

{
    "STATUS": "Succeeded"
}

トークン属性ルール識別名のPOSTメソッド(ドキュメント・コンテキスト)

このPOSTメソッドは、ドキュメントのコンテキストに対応する信頼できる識別名(DN)のトークン属性ルール(つまり、特定のドキュメントに適用されるルール)を作成するために使用します。この操作は、RESTサービスまたはクライアントにより実行できます。クライアント側ではトークン属性のマッピングのみがサポートされます。

RESTリクエスト

POST /idaas/webservice/admin/v1/trust/token/{documentName}

パラメータ

次の表は、POSTリクエストのパラメータの概要を示します。

名前 説明 タイプ

documentName

トークン属性ルールを作成するドキュメントの名前。

パス

リクエスト本文

メディア・タイプ:

application/json

リクエスト本文には、追加リクエストの詳細が含まれます。

属性 説明

"attributes"

信頼できるユーザーの制約フィルタおよびマッピングの属性をグループ化します。

注意: クライアント側では、この属性は必要ではありません。

"-dn"

サービス側では、属性ルールが構成される信頼できるDNに設定します。RFC 2253に従った文字列を使用します(次のURLを参照: http://www.ietf.org/rfc/rfc2253.txt)。

クライアント側では、http(s)://hostまたはhttp(s)://host/rootの形式を使用して、この値を、対象のサービスをホストしているドメインのURLに設定します。たとえば、この値をhttps://messaging.us2.com/に設定した場合、https://messaging.us2.com/<path>の形式のサービスURLを使用したサービスの起動すべてに属性ルールが適用されます。

"filter"

信頼できるユーザーの制約値および属性を定義します。

注意: この属性は、クライアント側では適用されません。

"mapping"

信頼できるユーザーのマッピング属性を定義します。

"-name"

属性ルールの名前。

注意: この属性は、クライアント側では適用されません。

"name-id"

信頼できるDNとして受け入れるユーザーを定義します。

"token-attribute-rule"

1つのトークン属性ルールに関する情報をグループ化します。

"tokn-attribute-rules"

すべてのトークン属性ルールに関する情報をグループ化します。

"user-attribute"

信頼できるDNがアサートできるユーザー属性を定義します。

注意: この属性は、クライアント側では適用されません。

"user-mapping-attribute"

信頼できるDNがアサートできるユーザー・マッピング属性を定義します。

"value"

制約フィルタの属性値を定義します。この値には、完全な名前またはワイルドカード文字(*)を含む名前パターン(yourTrusted*など)を使用できます。複数の値は、カンマで区切る必要があります。

注意: この属性は、クライアント側では適用されません。

レスポンス本文

メディア・タイプ:

application/json

返されるレスポンス本文には、インポート操作に関する次のようなステータスが含まれます。

属性 説明

"ERROR_CODE"

"STATUS"が"Failed"に設定されている場合はエラー・コードが提供されます。

"ERROR_MSG"

"STATUS"が"Failed"に設定されている場合はエラー・メッセージの内容が提供されます。

"STATUS"

操作のステータス。たとえば、"Succeeded"または"Failed"。

cURLの例

テスト済

次の例は、cURLを使用してRESTリソースにPOSTリクエストを発行して信頼できるDNのトークン属性ルールを作成する方法を示しています。

curl -i -X POST -u username:password --data @createrule.json http://myhost:7001/idaas/webservice/admin/v1/trust/token/mydocument

リクエスト本文の例(サービス側)

次の例は、サービス側で信頼できるDNのトークン属性ルールを作成する場合のJSON形式のリクエスト本文です。

{
    "token-attribute-rules":
    {
        "token-attribute-rule": 
        [
            {
                "-dn": "cn=orcladmin,o=oracle",
                "name-id":{
                    "filter": 
                    {
                        "value":[ "filter1" ]
                    },
                    "mapping":
                    {
                        "user-attribute": "val3",
                        "user-mapping-attribute":"val4"
                    }
                },
                "attributes":
                [
                    {
                        "-name": "tenant1",
                        "attribute":
                        {
                            "filter":
                            {
                                "value": [
                                    "filter1",
                                    "filter2"
                                ]
                            },
                            "mapping":{
                                "user-attribute": "val1",
                                "user-mapping-attribute":"val2"
                            }
                        }
                    }
                ]
            }
        ]
    }
}

リクエスト本文の例(クライアント側)

次の例は、クライアント側でトークン属性ルールを作成する場合のJSON形式のリクエスト本文です。

{
    "token-attribute-rules":
    {
        "token-attribute-rule": 
        [
            {
                "-dn": "https://messaging.us2.com/",
                "name-id":{
                    "mapping":
                    {
                        "user-mapping-attribute":"mail"
                    }
                },
            }
        ]
        "token-attribute-rule": 
        [
            {
                "-dn": "https://messaging.us2.com/mysvcInstance1-acme/",
                "name-id":{
                    "mapping":
                    {
                        "user-mapping-attribute":"uid"
                    }
                },
            }
        ]
    }
}

レスポンス・ヘッダーの例

レスポンス・ヘッダーの例を次に示します。

HTTP/1.1 200 OK

レスポンス本文の例

JSON形式のレスポンス本文の例を次に示します。

{
    "STATUS": "Succeeded"
}

すべてのトークン属性のGETメソッド

このGETメソッドは、ドメインのコンテキストに対応するすべてのトークン属性ルール(ドメイン全体に適用されるルール)を参照するために使用します。この操作は、RESTサービスまたはクライアントにより実行できます。クライアント側ではトークン属性のマッピングのみがサポートされます。

RESTリクエスト

GET /idaas/webservice/admin/v1/trust/token

レスポンス本文

メディア・タイプ:

application/json

レスポンス本文には、すべてのトークン属性ルールに関する次のような情報が含まれます。

属性 説明

"attributes"

信頼できるユーザーの制約フィルタおよびマッピングの属性をグループ化します。

注意: クライアント側では、この属性は必要ではありません。

"-dn"

サービス側では、属性ルールが構成される信頼できるDN。文字列は、RFC 2253に従います(次のURLを参照: http://www.ietf.org/rfc/rfc2253.txt)。

クライアント側では、http(s)://hostまたはhttp(s)://host/rootの形式を使用したURLを指定します。

"filter"

信頼できるユーザーのフィルタ値および属性を定義します。

完全な名前またはワイルドカード文字(*)を含む名前パターン(yourTrusted*など)を入力できます。複数の属性フィルタを指定する場合は、各フィルタをカンマで区切る必要があります。

"mapping"

信頼できるユーザーのマッピング属性を定義します。

注意: この属性は、クライアント側では適用されません。

"-name"

属性ルールの名前。

注意: この属性は、クライアント側では適用されません。

"name-id"

信頼できるDNとして受け入れるユーザーを定義します。

"token-attribute-rule"

1つのトークン属性ルールに関する情報をグループ化します。

"tokn-attribute-rules"

すべてのトークン属性ルールに関する情報をグループ化します。

"user-attribute"

信頼できるDNがアサートできるユーザー属性を定義します。

注意: この属性は、クライアント側では適用されません。

"user-mapping-attribute"

信頼できるDNがアサートできるユーザー・マッピング属性を定義します。

"value"

制約フィルタの属性値を定義します。この値には、完全な名前またはワイルドカード文字(*)を含む名前パターン(yourTrusted*など)を使用できます。複数の値は、カンマで区切る必要があります。

cURLの例

メインに対してテスト済 -- レビュー時にURLの信頼ドキュメント名を削除するように依頼されました。

次の例は、cURLを使用してRESTリソースにGETリクエストを発行して、すべてのトークン属性ルールを参照する方法を示しています。

curl -i -X GET -u username:password http://myhost:7001/idaas/platform/admin/v1/trust/token

レスポンス・ヘッダーの例

レスポンス・ヘッダーの例を次に示します。

HTTP/1.1 200 OK

レスポンス本文の例(サービス側)

次の例は、サービス側でトークン属性ルールを参照する場合のJSON形式のレスポンス本文です。

{
    "token-attribute-rules":
    {
        "token-attribute-rule": 
        [
            {
                "-dn": "cn=orcladmin,o=oracle",
                "attributes":
                [
                    {
                        "-name": "tenant1",
                        "attribute":
                        {
                            "filter":
                            {
                                "value": [
                                    "filter1",
                                    "filter2"
                                ]
                            },
                            "mapping":{
                                "user-attribute": "val1",
                                "user-mapping-attribute":"val2"
                            }
                        }
                    }
                ],
                "name-id":{
                    "filter": 
                    {
                        "value":[ "filter1" ]
                    },
                    "mapping":
                    {
                        "user-attribute": "val3",
                        "user-mapping-attribute":"val4"
                    }
                }
            }
        ]
    }
}

レスポンス本文の例(クライアント側)

次の例は、クライアント側でトークン属性ルールを参照する場合のJSON形式のレスポンス本文です。

{
    "token-attribute-rules":
    {
        "token-attribute-rule": 
        [
            {
                "-dn": "https://messaging.us2.com/",
                "name-id":{
                    "mapping":
                    {
                        "user-mapping-attribute":"mail"
                    }
                },
            }
        ]
        "token-attribute-rule": 
        [
            {
                "-dn": "https://messaging.us2.com/mysvcInstance1-acme/",
                "name-id":{
                    "mapping":
                    {
                        "user-mapping-attribute":"uid"
                    }
                },
            }
        ]
    }
}

指定したドキュメント・トークン属性ルールのGETメソッド

このGETメソッドは、特定のドキュメントに対応するトークン属性ルールを参照するために使用します。この操作は、RESTサービスまたはクライアントにより実行できます。クライアント側ではトークン属性のマッピングのみがサポートされます。

RESTリクエスト

GET /idaas/webservice/admin/v1/trust/token/{documentName}

パラメータ

次の表は、GETリクエストのパラメータの概要を示します。

名前 説明 タイプ

documentName

トークン属性ルールを参照するドキュメントの名前。

パス

レスポンス本文

メディア・タイプ:

application/json

レスポンス本文には、ドキュメントに対応するすべてのトークン属性ルールに関する情報が含まれます。この情報には、次のものが含まれます。

属性 説明

"attributes"

信頼できるユーザーの制約フィルタおよびマッピングの属性をグループ化します。

注意: クライアント側では、この属性は必要ではありません。

"-dn"

サービス側では、属性ルールが構成される信頼できるDN。文字列は、RFC 2253に従います(次のURLを参照: http://www.ietf.org/rfc/rfc2253.txt)。

クライアント側では、http(s)://hostまたはhttp(s)://host/rootの形式を使用したURLを指定します。

"filter"

信頼できるユーザーのフィルタ値および属性を定義します。

完全な名前またはワイルドカード文字(*)を含む名前パターン(yourTrusted*など)を入力できます。複数の属性フィルタを指定する場合は、各フィルタをカンマで区切る必要があります。

"mapping"

信頼できるユーザーのマッピング属性を定義します。

注意: この属性は、クライアント側では適用されません。

"-name"

属性ルールの名前。

注意: この属性は、クライアント側では適用されません。

"name-id"

信頼できるDNとして受け入れるユーザーを定義します。

"token-attribute-rule"

1つのトークン属性ルールに関する情報をグループ化します。

"tokn-attribute-rules"

すべてのトークン属性ルールに関する情報をグループ化します。

"user-attribute"

信頼できるDNがアサートできるユーザー属性を定義します。

注意: この属性は、クライアント側では適用されません。

"user-mapping-attribute"

信頼できるDNがアサートできるユーザー・マッピング属性を定義します。

"value"

制約フィルタの属性値を定義します。この値には、完全な名前またはワイルドカード文字(*)を含む名前パターン(yourTrusted*など)を使用できます。複数の値は、カンマで区切る必要があります。

cURLの例

メインに対してテスト済 -- レビュー時にURLの信頼ドキュメント名を削除するように依頼されました。

次の例は、cURLを使用してRESTリソースにGETリクエストを発行して、すべてのトークン属性ルールを参照する方法を示しています。

curl -i -X GET -u username:password http://myhost:7001/idaas/platform/admin/v1/trust/token/mydocument

レスポンス・ヘッダーの例

レスポンス・ヘッダーの例を次に示します。

HTTP/1.1 200 OK

レスポンス本文の例(サービス側)

次の例は、サービス側でトークン属性ルールを参照する場合のJSON形式のレスポンス本文です。

{
    "token-attribute-rules":
    {
        "token-attribute-rule": 
        [
            {
                "-dn": "cn=orcladmin,o=oracle",
                "attributes":
                [
                    {
                        "-name": "tenant1",
                        "attribute":
                        {
                            "filter":
                            {
                                "value": [
                                    "filter1",
                                    "filter2"
                                ]
                            },
                            "mapping":{
                                "user-attribute": "val1",
                                "user-mapping-attribute":"val2"
                            }
                        }
                    }
                ],
                "name-id":{
                    "filter": 
                    {
                        "value":[ "filter1" ]
                    },
                    "mapping":
                    {
                        "user-attribute": "val3",
                        "user-mapping-attribute":"val4"
                    }
                }
            }
        ]
    }
}

レスポンス本文の例(クライアント側)

次の例は、クライアント側でトークン属性ルールを参照する場合のJSON形式のレスポンス本文です。

{
    "token-attribute-rules":
    {
        "token-attribute-rule": 
        [
            {
                "-dn": "https://messaging.us2.com/",
                "name-id":{
                    "mapping":
                    {
                        "user-mapping-attribute":"mail"
                    }
                },
            }
        ]
        "token-attribute-rule": 
        [
            {
                "-dn": "https://messaging.us2.com/mysvcInstance1-acme/",
                "name-id":{
                    "mapping":
                    {
                        "user-mapping-attribute":"uid"
                    }
                },
            }
        ]
    }
}

信頼ドキュメント名の構成のインポート・メソッド

このPOSTメソッドは、信頼できる発行者の構成(発行者名、識別名(DN)リスト、およびトークン属性ルールを含む)をインポートするために使用します。

RESTリクエスト

POST /idaas/webservice/admin/v1/trustdocument/import

リクエスト本文

メディア・タイプ:

application/xml

リクエスト本文には、XML形式のインポート・リクエストの詳細が含まれます。信頼できる発行者ドキュメント作成して(「信頼ドキュメント名のPOSTメソッド」を参照)、そのドキュメントをoratrust:name要素を使用して渡す必要があります。次に例を示します。

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<oratrust:TokenIssuerTrust xmlns:oratrust="http://xmlns.oracle.com/wsm/security/trust" oratrust:name="trustdocument">
    <oratrust:Issuers>
        <oratrust:Issuer oratrust:name="www.oracle.com" oratrust:tokentype="saml.hok">
            <oratrust:TrustedKeys/>
        </oratrust:Issuer>
        <oratrust:Issuer oratrust:name="www.oracle.com" oratrust:tokentype="saml.sv">
            <oratrust:TrustedKeys/>
        </oratrust:Issuer>
        <oratrust:Issuer oratrust:name="www.oracle.com" oratrust:tokentype="jwt">
            <oratrust:TrustedKeys/>
        </oratrust:Issuer>
    </oratrust:Issuers>
    <oratrust:TokenAttributeRules/>
</oratrust:TokenIssuerTrust>

レスポンス本文

メディア・タイプ:

application/json

返されるレスポンス本文には、インポート操作に関する次のようなステータスが含まれます。

要素 説明

"ERROR_CODE"

"STATUS"が"Failed"に設定されている場合はエラー・コードが提供されます。

"ERROR_MSG"

"STATUS"が"Failed"に設定されている場合はエラー・メッセージの内容が提供されます。

"Result"

操作結果の詳細。

"STATUS"

操作のステータス。たとえば、"Succeeded"または"Failed"。

cURLの例

次の例は、cURLを使用してRESTリソースにPOSTリクエストを発行して、別名のすべての証明書を参照する方法を示しています。

curl -i -X POST -u username:password --data @import.xml -H Content-Type:application/xml -H Accept:application/json http://myhost:7001/idaas/platform/admin/v1/trustdocument/import

リクエスト本文の例

JSON形式のリクエスト本文の例を次に示します。

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<oratrust:TokenIssuerTrust xmlns:oratrust="http://xmlns.oracle.com/wsm/security/trust" oratrust:name="test">
    <oratrust:Issuers>
        <oratrust:Issuer oratrust:name="www.oracle.com" oratrust:tokentype="saml.hok">
            <oratrust:TrustedKeys/>
        </oratrust:Issuer>
        <oratrust:Issuer oratrust:name="www.oracle.com" oratrust:tokentype="saml.sv">
            <oratrust:TrustedKeys/>
        </oratrust:Issuer>
        <oratrust:Issuer oratrust:name="www.oracle.com" oratrust:tokentype="jwt">
            <oratrust:TrustedKeys/>
        </oratrust:Issuer>
    </oratrust:Issuers>
    <oratrust:TokenAttributeRules/>
</oratrust:TokenIssuerTrust>

信頼ドキュメントのGETメソッド

このGETメソッドは、信頼できる発行者ドキュメントの構成の詳細を参照するために使用します。

RESTリクエスト

GET /idaas/webservice/admin/v1/trustdocument

パラメータ

次の表は、POSTリクエストのパラメータの概要を示します。

名前 説明 タイプ

"documentName"

ドキュメントの名前。

問合せ

レスポンス本文

メディア・タイプ:

application/json

返されるレスポンス本文には、インポート操作に関する次のようなステータスが含まれます。

属性 説明

"ERROR_CODE"

"STATUS"が"Failed"に設定されている場合はエラー・コードが提供されます。

"ERROR_MSG"

"STATUS"が"Failed"に設定されている場合はエラー・メッセージの内容が提供されます。

"Result"

操作結果の詳細。

"STATUS"

操作のステータス。たとえば、"Succeeded"または"Failed"。

cURLの例

次の例は、cURLを使用してRESTリソースにGETリクエストを発行して、すべてのトークン属性ルールを参照する方法を示しています。

curl -i -X GET -u username:password http://myhost:7001/idaas/platform/admin/v1/trustdocument?"documentName=myTrustDocument"

レスポンス・ヘッダーの例

レスポンス・ヘッダーの例を次に示します。

HTTP/1.1 200 OK

レスポンス本文の例

JSON形式のレスポンス本文の例を次に示します。

{
    "STATUS":"Succeeded",
    "Result":"List of token issuer trust documents in the Repository:\nDetails of the document matching your request:\nName         : myTrustDocument\tDisplay Name : myTrustDocument\tStatus       : DOCUMENT_STATUS_COMMITED \nList of trusted issuers for this type:\tNone\nList of Token Attribute Rules\tNone"
}

信頼ドキュメントのDELETEメソッド

Deleteメソッドは、信頼できる発行者ドキュメントを削除するために使用します。

RESTリクエスト

DELETE /idaas/webservice/admin/v1/trustdocument

パラメータ

次の表は、DELETEリクエストのパラメータの概要を示します。

名前 説明 タイプ

"displayName"

ドキュメントの表示名。

問合せ

"documentName"

信頼できる発行者ドキュメントの名前。

問合せ

レスポンス本文

メディア・タイプ:

application/json

返されるレスポンス本文には、インポート操作に関する次のようなステータスが含まれます。

属性 説明

"ERROR_CODE"

"STATUS"が"Failed"に設定されている場合はエラー・コードが提供されます。

"ERROR_MSG"

"STATUS"が"Failed"に設定されている場合はエラー・メッセージの内容が提供されます。

"Result"

操作結果の詳細。

"STATUS"

操作のステータス。たとえば、"Succeeded"または"Failed"。

cURLの例

テスト済

次の例は、cURLを使用してRESTリソースにDELETEリクエストを発行することで、SAML発行者の信頼ドキュメントを削除する方法を示しています。

curl -i -X DELETE -u username:password http://myhost:7001/idaas/webservice/admin/v1/trustdocument?"documentName=myTrustDocument&displayName=myTrustDocument"

レスポンス・ヘッダーの例

レスポンス・ヘッダーの例を次に示します。HTTPステータス・コードの詳細は、「HTTPメソッドのHTTPステータス・コード」を参照してください。

HTTP/1.1 200 OK

レスポンス本文の例

JSON形式のレスポンス本文の例を次に示します。

{
    "STATUS": "Succeeded",
    "Result": "Token Issuer Trust document named "myTrustDocument" deleted from the repository."
}
前
前 		次
次
目次へ移動
目次