Skip to content

Commit

Permalink
Update docs/channels_configuration.rst
Browse files Browse the repository at this point in the history
Co-authored-by: Felix Schneider <[email protected]>
  • Loading branch information
PSanetra and felicijus committed Nov 7, 2024
1 parent 50daad0 commit 58f7404
Showing 1 changed file with 17 additions and 14 deletions.
31 changes: 17 additions & 14 deletions docs/channels_configuration.rst
Original file line number Diff line number Diff line change
Expand Up @@ -22,10 +22,11 @@ This variables is used across all types of channels:

:Usage:
Used in both secure and insecure channel configurations.
:func:`pyzeebe.create_insecure_channel` and :func:`pyzeebe.create_secure_channel`.
:func:`pyzeebe.create_insecure_channel`
:func:`pyzeebe.create_secure_channel`

:Default:
`"localhost:26500"`
``"localhost:26500"``

Common OAuth2 Variables
-----------------------
Expand All @@ -38,15 +39,17 @@ These variables are specifically for connecting to generic OAuth2 or Camunda Clo

:Usage:
Required for OAuth2 and Camunda Cloud channels.
:func:`pyzeebe.create_oauth2_client_credentials_channel` and :func:`pyzeebe.create_camunda_cloud_channel`.
:func:`pyzeebe.create_oauth2_client_credentials_channel`
:func:`pyzeebe.create_camunda_cloud_channel`

**CAMUNDA_CLIENT_SECRET** / **ZEEBE_CLIENT_SECRET**
:Description:
The client secret for the OAuth2 client.

:Usage:
Required for OAuth2 and Camunda Cloud channels.
:func:`pyzeebe.create_oauth2_client_credentials_channel` and :func:`pyzeebe.create_camunda_cloud_channel`.
:func:`pyzeebe.create_oauth2_client_credentials_channel`
:func:`pyzeebe.create_camunda_cloud_channel`

OAuth2 Variables (Self-Managed)
-------------------------------
Expand All @@ -59,18 +62,18 @@ These variables are primarily used for OAuth2 authentication in self-managed Cam

:Usage:
Required if channel initialization argument was not specified.
:func:`pyzeebe.create_oauth2_client_credentials_channel`.
:func:`pyzeebe.create_oauth2_client_credentials_channel`

**CAMUNDA_TOKEN_AUDIENCE** / **ZEEBE_TOKEN_AUDIENCE**
:Description:
Specifies the audience for the OAuth2 token.

:Usage:
Used when creating OAuth2 or Camunda Cloud channels.
:func:`pyzeebe.create_oauth2_client_credentials_channel`

:Default:
None if not provided.
:func:`pyzeebe.create_oauth2_client_credentials_channel`.
``None`` if not provided.

Camunda Cloud Variables (SaaS)
------------------------------
Expand All @@ -83,38 +86,38 @@ These variables are specifically for connecting to Camunda Cloud instances.

:Usage:
Used in the OAuth2 and Camunda Cloud channel configurations.
:func:`pyzeebe.create_camunda_cloud_channel`

:Default:
`"https://login.cloud.camunda.io/oauth/token"` if not specified.
:func:`pyzeebe.create_camunda_cloud_channel`.
``"https://login.cloud.camunda.io/oauth/token"`` if not specified.

**CAMUNDA_CLUSTER_ID**
:Description:
The unique identifier for the Camunda Cloud cluster to connect to.

:Usage:
Required if channel initialization argument was not specified.
:func:`pyzeebe.create_camunda_cloud_channel`.
:func:`pyzeebe.create_camunda_cloud_channel`

**CAMUNDA_CLUSTER_REGION**
:Description:
The region where the Camunda Cloud cluster is hosted.

:Usage:
Required for Camunda Cloud channels.
:func:`pyzeebe.create_camunda_cloud_channel`

:Default:
`"bru-2"` if not provided.
:func:`pyzeebe.create_camunda_cloud_channel`.
``"bru-2"`` if not provided.

**CAMUNDA_TOKEN_AUDIENCE** / **ZEEBE_TOKEN_AUDIENCE**
:Description:
Specifies the audience for the OAuth2 token.

:Usage:
Used when creating OAuth2 or Camunda Cloud channels.
:func:`pyzeebe.create_camunda_cloud_channel`

:Default:
`"zeebe.camunda.io"` if not provided.
:func:`pyzeebe.create_camunda_cloud_channel`.
``"zeebe.camunda.io"`` if not provided.

0 comments on commit 58f7404

Please sign in to comment.