Fortinet black logo

New Features

OAuth 2.0 authentication for webhook connectors

Copy Link
Copy Doc ID 7d55ae6f-8e83-11ec-9fd1-fa163e15d75b:261518
Download PDF

OAuth 2.0 authentication for webhook connectors

OAuth 2.0 is now available for webhook connectors to provide simple, consistent, and secure authentication.

To configure OAuth 2.0 for a webhook connector:
  1. Go to Fabric View > Fabric > Connectors, and click Create New.
  2. Under the ITSM category, click Generic Connector.

    You can also configure OAuth 2.0 authentication for an existing webhook connector by selecting the connector and clicking Edit.

  3. Configure the following properties:

    Name

    Type a name for the connector.

    Description

    (Optional) Type a description for the connector.

    Protocol

    Select the protocol FortiAnalyzer uses to communicate with the external platform.

    Port

    Type the port FortiAnalyzer uses to communicate with the external platform.

    Method

    Title

    Type a title for the connector.

    URL

    Type the URL of the external platform.

    Enable HTTP Authentication

    Set HTTP authentication to ON.

    Auth Type

    Select OAuth2.

    Authorization Server

    Type the URL of the token service. The token service must be publicly available.

    Auth Client ID

    Type the client ID from the token service.

    Auth Client Secret

    Type the client secret from the token service.

    Status

    Set status to ON to enable the fabric connector.

  4. Click OK.

    Backend OAuth 2.0 libraries in FortiAnalyzer connect to the token service and authenticate with the provided client ID and client secret. When authentication is successful, FortiAnalyzer receives a token with a TTL and scope attached to it. FortiAnalyzer will use this token for all webhook connections to the token service until TTL expires.

OAuth 2.0 authentication for webhook connectors

OAuth 2.0 is now available for webhook connectors to provide simple, consistent, and secure authentication.

To configure OAuth 2.0 for a webhook connector:
  1. Go to Fabric View > Fabric > Connectors, and click Create New.
  2. Under the ITSM category, click Generic Connector.

    You can also configure OAuth 2.0 authentication for an existing webhook connector by selecting the connector and clicking Edit.

  3. Configure the following properties:

    Name

    Type a name for the connector.

    Description

    (Optional) Type a description for the connector.

    Protocol

    Select the protocol FortiAnalyzer uses to communicate with the external platform.

    Port

    Type the port FortiAnalyzer uses to communicate with the external platform.

    Method

    Title

    Type a title for the connector.

    URL

    Type the URL of the external platform.

    Enable HTTP Authentication

    Set HTTP authentication to ON.

    Auth Type

    Select OAuth2.

    Authorization Server

    Type the URL of the token service. The token service must be publicly available.

    Auth Client ID

    Type the client ID from the token service.

    Auth Client Secret

    Type the client secret from the token service.

    Status

    Set status to ON to enable the fabric connector.

  4. Click OK.

    Backend OAuth 2.0 libraries in FortiAnalyzer connect to the token service and authenticate with the provided client ID and client secret. When authentication is successful, FortiAnalyzer receives a token with a TTL and scope attached to it. FortiAnalyzer will use this token for all webhook connections to the token service until TTL expires.