REST API for OAuth in Oracle Access Manager

Update mTLS end point alias

put

/oam/services/rest/ssa/api/v1/hostalias/mtls

Request

Supported Media Types

application/json

MTLS end point alias configuration

Root Schema : mTLSEndpoint

Type: object

Show Source

hostname(required): string

Host name of the mTLS end point
port(required): string

Port of the mTLS end point

{
    "type":"object",
    "required":[
        "hostname",
        "port"
    ],
    "properties":{
        "hostname":{
            "type":"string",
            "description":"Host name of the mTLS end point"
        },
        "port":{
            "type":"string",
            "description":"Port of the mTLS end point"
        }
    }
}

Response

Supported Media Types

application/json

200 Response

Sucessfully modified entity - mTLS Configuration, detail -

Root Schema : mTLSEndpointResponse

Type: object

Show Source

hostname: string

Host name of the mTLS end point
message: string

Error messages
port: string

Port of the mTLS end point

{
    "type":"object",
    "properties":{
        "hostname":{
            "type":"string",
            "description":"Host name of the mTLS end point"
        },
        "port":{
            "type":"string",
            "description":"Port of the mTLS end point"
        },
        "message":{
            "type":"string",
            "description":"Error messages"
        }
    }
}

422 Response

Failed to create entity - mTLS Configuration. Invalid Input.

Examples

cURL Sample Request

curl --location --request PUT 'https://<admin-host>:<admin-port>/oam/services/rest/ssa/api/v1/hostalias/mtls' \
--header 'Authorization: Basic dGVzdDp0ZXN0=' \
--header 'Content-Type: application/json' \
--data-raw '{
    "hostname": "hostname1",
    "port": "4443"
}'

cURL Sample Response

Sucessfully modified entity - MTLSConfiguration, detail - {"hostname":"hostname1","port":"4443"}