Authorizer
    • PDF

    Authorizer

    • PDF

    Article Summary

    Create an authorizer

    URL

    POST https://apigateway.apigw.ntruss.com/api/v1/authorizers
    

    Request Parameter

    • None

    Request Body

    {
      "cacheTtlSec" : 0,
      "authorizerName" : "authorizerName",
      "authorizerConfig" : {
        "functionId" : "functionId",
        "payload" : [ {
          "in" : "HEADER",
          "name" : "name"
        } ],
        "region" : "region"
      },
      "authorizerType" : "CLOUD_FUNCTIONS",
      "authorizerDescription" : "authorizerDescription"
    }
    

    Response Code

    • 201

    Response Body

    {
      "cacheTtlSec" : 0,
      "authorizerId" : "authorizerId",
      "domainCode" : "domainCode",
      "modTime" : "2000-01-23T04:56:07.000+00:00",
      "modifier" : "modifier",
      "authorizerName" : "authorizerName",
      "tenantId" : "tenantId",
      "authorizerConfig" : {
        "functionId" : "functionId",
        "payload" : [ {
          "in" : "HEADER",
          "name" : "name"
        } ],
        "region" : "region"
      },
      "authorizerType" : "authorizerType",
      "authorizerDescription" : "authorizerDescription"
    }
    

    Delete an authorizer

    URL

    DELETE https://apigateway.apigw.ntruss.com/api/v1/authorizers/{authorizer-id}
    

    Request Parameter

    NamePositionRequiredTypeDescription
    authorizerIdpathYStringAuthorizer Id
    Length(Min/Max): 0/10

    Request Body

    • None

    Response Code

    • 204

    Response Body

    • None

    Get an authorizer

    URL

    GET https://apigateway.apigw.ntruss.com/api/v1/authorizers/{authorizer-id}
    

    Request Parameter

    NamePositionRequiredTypeDescription
    authorizerIdpathYStringAuthorizer Id
    Length(Min/Max): 0/10

    Request Body

    • None

    Response Code

    • 200

    Response Body

    {
      "cacheTtlSec" : 0,
      "authorizerId" : "authorizerId",
      "domainCode" : "domainCode",
      "modTime" : "2000-01-23T04:56:07.000+00:00",
      "modifier" : "modifier",
      "authorizerName" : "authorizerName",
      "tenantId" : "tenantId",
      "authorizerConfig" : {
        "functionId" : "functionId",
        "payload" : [ {
          "in" : "HEADER",
          "name" : "name"
        } ],
        "region" : "region"
      },
      "authorizerType" : "authorizerType",
      "authorizerDescription" : "authorizerDescription"
    }
    

    Search authorizers by authorizerName

    URL

    GET https://apigateway.apigw.ntruss.com/api/v1/authorizers
    

    Request Parameter

    NamePositionRequiredTypeDescription
    offsetquery stringNLongOffset
    Min: 0
    Max: 9,223,372,036,854,775,807
    limitquery stringNLongLimit
    Min: 1
    Max: 9,223,372,036,854,775,807
    namequery stringNStringName
    Length(Min/Max): 0/20

    Request Body

    • None

    Response Code

    • 200

    Response Body

    {
      "initialCount" : 0,
      "total" : 6,
      "authorizers" : [ {
        "authorizerId" : "authorizerId",
        "authorizerName" : "authorizerName",
        "disabled" : true,
        "permission" : "permission",
        "authorizerDescription" : "authorizerDescription",
        "actionName" : "actionName"
      } ]
    }
    

    Modify an authorizer

    URL

    PUT https://apigateway.apigw.ntruss.com/api/v1/authorizers/{authorizer-id}
    

    Request Parameter

    NamePositionRequiredTypeDescription
    authorizerIdpathYStringAuthorizer Id
    Length(Min/Max): 0/10

    Request Body

    {
      "cacheTtlSec" : 0,
      "authorizerName" : "authorizerName",
      "authorizerConfig" : {
        "functionId" : "functionId",
        "payload" : [ {
          "in" : "HEADER",
          "name" : "name"
        } ],
        "region" : "region"
      },
      "authorizerType" : "CLOUD_FUNCTIONS",
      "authorizerDescription" : "authorizerDescription"
    }
    

    Response Code

    • 204

    Response Body

    • None

    Test authorizer

    URL

    POST https://apigateway.apigw.ntruss.com/api/v1/authorizers/{authorizer-id}/test
    

    Request Parameter

    NamePositionRequiredTypeDescription
    authorizerIdpathYStringAuthorizer Id
    Length(Min/Max): 0/10

    Request Body

    {
      "params" : "{}"
    }
    

    Response Code

    • 200

    Response Body

    {
      "response" : {
        "latency" : "latency",
        "body" : "{}",
        "status" : 0
      }
    }
    

    Was this article helpful?

    What's Next
    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.