• Python
  • Installation
  • Environment Variables
    • HTTPS
    • AUDIENCE
    • TRANSCEND_API_KEY
    • SOMBRA_API_KEY
    • SOMBRA_URL
  • Start
  • Open the browser
  • Add to your Data Map

Internal system integrations in Python. Check out the parent README for more context.

If you are in a Codespace, you can run pip install -r requirements.txt.

If you are running this locally, ensure you are using python 3.8.x, and then run:

python3 -m venv env
source ./env/bin/activate
pip3 install -r requirements.txt

In order to run the server with HTTPS enabled, you need to make sure you have your own SSL certificate and private key. If you don't need to have it enabled, you can set the following environment variable:

export USE_HTTPS=false

Else you can use your certificate and private key, and set it on the code on main.py file

   httpd.socket = ssl.wrap_socket(
      httpd.socket,
      keyfile="ssl/private.key",
      certfile='ssl/certificate.pem',
      server_side=True
   )

If you want to verify the JWT token, you need to set the AUDIENCE environment variable.

You can find the audience on your Organization URI at https://app.transcend.io/infrastructure/sombra.

This API key authenticates you to Transcend, and you can generate it on the admin dashboard. API keys must be scoped to certain operations or data silos.

This API key authenticates you to to your Sombra gateway.

• If you're using 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 will receive this via a secure channel.

This is the URL of your Sombra gateway.

• If you're using multi-tenant Sombra (most common), this is https://multi-tenant.sombra.transcend.io.
• If you are self-hosting Sombra, you assign this value.
• If Transcend is hosting the gateway on your behalf in a single-tenant instance, this is https://<ORGANIZATION_URI>.sombra.transcend.io.

python main.py

Go to https://localhost:4443

You can test against this example live by adding it to your Integrations and using ngrok to map your localhost to a live domain.

ngrok http --hostname=test-python.ngrok.io 4443