Jump to

• Request
• Response

Find OAuth Identity Domain by name or ID

get

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

Returns an Identity Domain. The search can be done either with the name or the ID of the Identity Domain. Only one of the query parameters needs to be specified.

Request

Supported Media Types

• application/json

Query Parameters

• id: string
  Unique ID of the Identity Domain
• name: string
  Name of the Identity Domain.

Response

Supported Media Types

• application/json

200 Response

Sucessfully retrieved entity - OAuthIdentityDomain, detail

Body ()

Root Schema : IdentityDomain

Type: object

Show Source

• consentPageURL: string
  Fully qualified URL of the customized consent page
• customAttrs: string
  Attribute of user in IDStore to store the encrypted secretkey for TOTP
• description: string
• errorPageURL: string
  Fully qualified URL of the customized error page
• identityProvider: string
  Name of the identity store against which authentication is completed
• name: string
  Name of the Identity Domain
• tokenSettings: array tokenSetting

{
    "type":"object",
    "required":[
        "name"
    ],
    "properties":{
        "name":{
            "type":"string",
            "description":"Name of the Identity Domain"
        },
        "consentPageURL":{
            "type":"string",
            "description":"Fully qualified URL of the customized consent page"
        },
        "errorPageURL":{
            "type":"string",
            "description":"Fully qualified URL of the customized error page"
        },
        "identityProvider":{
            "type":"string",
            "description":"Name of the identity store against which authentication is completed"
        },
        "description":{
            "type":"string"
        },
        "customAttrs":{
            "type":"string",
            "description":"Attribute of user in IDStore to store the encrypted secretkey for TOTP"
        },
        "tokenSettings":{
            "type":"array",
            "xml":{
                "name":"tokenSetting",
                "wrapped":true
            },
            "items":{
                "$ref":"#/definitions/TokenSettings"
            }
        }
    }
}

Nested Schema : tokenSetting

Type: array

Show Source

• [0]: object TokenSettings

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

Nested Schema : TokenSettings

Type: object

Show Source

• lifeCycleEnabled: boolean
  Default Value: false
• refreshTokenEnabled: boolean
  Default Value: false
• refreshTokenExpiry: integer(int64)
• refreshTokenLifeCycleEnabled: boolean
  Default Value: false
• tokenExpiry: integer(int64)
• tokenType: string
  Allowed Values: [ "ACCESS_TOKEN", "AUTHZ_CODE", "SSO_LINK_TOKEN" ]

  Type of the token

{
    "type":"object",
    "required":[
        "refreshTokenEnabled",
        "refreshTokenExpiry",
        "tokenType",
        "tokenExpiry"
    ],
    "properties":{
        "refreshTokenEnabled":{
            "type":"boolean",
            "default":false
        },
        "refreshTokenLifeCycleEnabled":{
            "type":"boolean",
            "default":false
        },
        "refreshTokenExpiry":{
            "type":"integer",
            "format":"int64"
        },
        "lifeCycleEnabled":{
            "type":"boolean",
            "default":false
        },
        "tokenType":{
            "type":"string",
            "description":"Type of the token",
            "enum":[
                "ACCESS_TOKEN",
                "AUTHZ_CODE",
                "SSO_LINK_TOKEN"
            ]
        },
        "tokenExpiry":{
            "type":"integer",
            "format":"int64"
        }
    }
}

422 Response

Failed to retrive OAuth entity "IdentityDomain" - name "NameofIdentityDomain"