You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 11 Next »

Introduction

In the OAS document, security schemes describe the type of authenticator being used and how API Connector Builder using the OAS document must authenticate itself.

Properties configuration

OAS3

Depending on the authentication method defined in the OAS document, configure the following possible properties:

  • OAS document: Upload and select the OAS document.
  • Download OAS Document: The Download button redownloads the uploaded OAS document.
  • Select API Server: Select the API server from the drop-down list.
  • region: Select the billing region from the drop-down list.
  • Grant Type: Select the method the application uses to obtain an access token. 
  • Scopes:
    • View allowance templates.
    • Create and update allowance templates.
    • Delete allowance templates.
  • Client ID: The Client ID provisioned by the OpenID provider when the client was registered. 
  • Client Secret: The Client Secret (password) provisioned by the OpenID provider when the client is registered. 
  • Code Challenge Method:
  • Callback URL: URL to which Auth0 redirects users after they authenticate. 

Note

Ensure to provide this Callback URL to your OpenID Connect service.
  • Configuration Method: 
    • OpenID Connect Discovery 
    • Custom 
  • Authorization Code:
    • OpenID Connect Directory 
    • Get Authorization Code 
  • Custom: 
    • Issuer 
    • JSON Web Key Set 
    • Authorization Token Endpoint 
    • Token Endpoint
    • Scopes 
  • Client Authentication: Select the client authentication type. 
    • Send as Basic Auth Header 
    • Send credentials in body 
  • Headers: 
    • NAME
    • VALUE

Design

asdw

Settings

  • ID: The API connector ID.
  • Name: The name of the API connector.
  • Description: The description of the API connector.
  • Logo: Assign a logo for the API connector.
  • Debug Mode: Show relevant debug in the server log for debugging purposes.

Preview

  • Select Operation: Select an API endpoint.
  • Description: The API endpoint description.
  • Depending on the operation selected, you will preview:
    • id: Available with the GET and DELETE methods. Specify the ID of the item to fetch or delete.
    • Payload: Available with the POST and PUT methods. The structure of the API in JSON or YAML format. You can add many more details, like authentication methods, request parameters, query parameters, or more complex schemas.

  • No labels