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.
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 |
| 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 |
| 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". |
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",
}