POST Document Trusted Issuers and Distinguished Name Lists Method

Use the POST method to create trusted issuers and distinguished name (DN) lists for signing certificates in a document context (that is, it applies to a specified document). The trusted issuers will be stored in the specified trusted issuers document.

REST Request

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

Parameters

The following table summarizes the POST request parameters.

Name Description Type
documentName Name of trusted issuer document. For information about creating a trusted issuer document, see "POST TrustDocument Name Method". Query

Request Body

Media Types: application/json

The request body contains the details of the add request:

Attribute Description Required
"dn" List of DN values to be added to the trusted issuer. For each DN, use a string that conforms to RFC 2253, as described at the following URL: http://www.ietf.org/rfc/rfc2253.txt Yes
"issuer" Groups information about a trusted issuer. Yes
"-name" Name of the trusted issuer. For example, www.yourcompany.com. The default value for the predefined SAML client policies is www.oracle.com. Yes
"jwt-trusted-dns" Groups information about JSON Web Token (JWT) trusted issuers. No
"saml-hok-trusted-dns" Groups information about SAML holder-of-key trusted issuers. No
"saml-sv-trusted-dns" Groups information about SAML sender vouches trusted issuers. No
"saml-trusted-dns" Groups the trusted issuers and DN lists. Yes

Response Body

Media Types: application/json

The response body returns the status of the import operation, including:

Attribute Description
"ERROR_CODE" If "STATUS" is set to "Failed", provides the error code.
"ERROR_MSG" If "STATUS" is set to "Failed", provides the contents of the error message.
"STATUS" Status of operation. For example, "Succeeded" or "Failed".

cURL Example

The following example shows how to create trusted issuers and DN lists by submitting a POST request on the REST resource using cURL

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

Example of Request Body

The following shows an example of the request body in JSON format.

{ 
    "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", ] 
            }
            ] 
        } 
    } 
}

Example of Response Header

The following shows an example of the response header.

HTTP/1.1 200 OK

Example of Response Body

The following shows an example of the response body in JSON format.

{
    "STATUS": "Succeeded",
}