Table of Contents

• Examples
  • What are these examples
  • Try it in your environment
    • TRANSCEND_API_KEY
    • SOMBRA_API_KEY
    • SOMBRA_URL
    • Audience
  • Languages
  • Try it on Replit

Examples

Some examples of how to integrate with Transcend in various languages. See our documentation for further information.

• Javascript
• Python
• Ruby
• Typescript
• [Coming soon] Go

What are these examples

These examples are meant to show you what the integration will look like when you connect your internal systems to Transcend.

Each language has an example of how to:

• Verify a webhook that is sent from Transcend (docs)
• Respond to ACCESS/ERASURE and other DSR webhooks (docs)

The JavaScript folder also has an example of how to:

• Perform identity enrichment by responding to a webhook (docs)

Using ngrok you can actually connect these examples to your Data Map.

Try it in your environment

To configure these examples, you will need to create a file named .env and fill it out with your configuration, or they can be set as environment variables

TRANSCEND_API_KEY="<TODO>"
SOMBRA_API_KEY="<TODO>"
SOMBRA_URL="https://<TODO>.sombra.transcend.io"
AUDIENCE="<TODO>"

TRANSCEND_API_KEY

This API key authenticates you to Transcend, and you can generate it on the admin dashboard. API keys must be scoped to the proper integration that you are responding to.

SOMBRA_API_KEY

This API key authenticates you to to your Sombra gateway.

• If you're using "Transcend Hosted - Multi Tenant" Sombra (most common) you don't need to set this.
• If you are self-hosting Sombra, you would have generated this at the time of setup and stored it securely.
• If Transcend is hosting the gateway on your behalf in a single-tenant instance, you should reach out to your account manager to get this key.

You can see which version of the Sombra Gateway you are using by visiting Infrastructure -> Sombra settings in the Admin Dashboard.

SOMBRA_URL

This is the URL of your Sombra gateway. You can find your URL by visiting Infrastructure -> Sombra settings in the Admin Dashboard. This URL is the value titled "CUSTOMER INGRESS URL".

Audience

This is the audience that you will verify is set on the incoming Json Web Tokens (JWTs). You can find your Sombra audience under Infrastructure -> Sombra in the Admin Dashboard. This URL is the value titled "SOMBRA AUDIENCE".

Languages

Check out your language of choice for further details

• JavaScript
• Typescript
• Python
• Ruby

Try it on Replit

If you want to try out an example that is ready to run, you can head to Replit and fork the example.

The example is located here. You will need to first fork the replit and then you can start running the code. The webhook url will be located in the url generated at the top right. You will need to update some of the secrets, including TRANSCEND_API_KEY.

Here are two videos of how to set it up on Replit:

• First part
• Second part