Configure Datawiza Cloud Management Console

Preview

In this section, we will show you how to create an application on the Datawiza Cloud Management Console (DCMC) and generate a pair of PROVISIONING_KEY and PROVISIONING_SECRET for this app. This key pair is used by the Datawiza Access Proxy to get the latest configurations and policies from the Datawiza Cloud Management Console.

Sign into DCMC

1. Log into the DCMC.

Create New Deployment In DCMC

Welcome to the DCMC homepage! Let's get started:

1. Click the orange button Getting started. Specify a Name and a Description, and click Next.

Add Application

Configure your application with the following values:

• Platform: WEB, API, AWS Elastic Map Reduce, or Oracle E-Business Suite
• App Name: Demo App
• Public Domain: http://localhost:9772
• Listen Port: 9772
• Upstream Servers: http://localhost:9902
• Select Next.

Note that upstream sever is the address of the application that you want to enable SSO.

• If you use the DAP in sidecar mode and your application is running on localhost:3001 on Mac or Windows, then set the upstream server to host.docker.internal:3001 (Docker 18.03+).
• If your application is running on Linux, use ip addr show docker0 to get docker host IP (e.g., 172.17.0.1) and then set upstream server to 172.17.0.1:3001 (see this for more details).
• If you do not have any prepared application, you can use our pre-built-in application and set upstream server to http://localhost:9902.

IdP Configuration

If you select WEB, AWS Elastic Map Reduce, or Oracle E-Business Suite as your Platform, you need to Configure IdP:

We provide four protocols for IdP: OIDC, SAML, LDAP, and OAUTH. For OIDC:

1. Choose your Identity Provider from the drop-down menu.

• Auth0

Populate the fields of the form with the keys/values obtained from IdP Configuration Guide: Auth0.

• Azure AD

Populate the fields of the form with the keys/values obtained from IdP Configuration Guide: Microsoft Azure AD. Alternatively, you can use One Click Integration to configure the Azure.

• Azure AD B2C

Populate the fields of the form with the keys/values obtained from IdP Configuration Guide: Microsoft Azure AD B2C.

• Cognito

Populate the fields of the form with the keys/values obtained from IdP Configuration Guide: Cognito.

• Keycloak

Populate the fields of the form with the keys/values obtained from IdP Configuration Guide: Keycloak.

• Generic OIDC

Populate the fields of the form with the keys/values obtained from your IdP.

• Google

Populate the fields of the form with the keys/values obtained from IdP Configuration Guide: Google.

• Google Workspace

Populate the fields of the form with the keys/values obtained from IdP Configuration Guide: Google Workspace.

• Okta

Populate the fields of the form with the keys/values obtained from IdP Configuration Guide: Okta.
Note that the Okta API Token is optional. It can be used to get more info about the user. You can see here for more details.

• PingOne

Populate the fields of the form with the keys/values obtained from IdP Configuration Guide: PingOne.

For SAML:

• Azure AD

Populate the fields of the form with the keys/values obtained from IdP Configuration Guide: Microsoft Azure AD SAML.

• Okta

Populate the fields of the form with the keys/values obtained from IdP Configuration Guide: Okta.

For OAUTH:

• Github

Populate the fields of the form with the keys/values obtained from IdP Configuration Guide: Github.

• Twitter

Populate the fields of the form with the keys/values obtained from IdP Configuration Guide: Twitter.

Authorizer Configuration

If you select API as your Platform, you need to Configure Authorizer:

We support two types of API authorization: Basic Auth and JWT

Basic Auth

For Basic Auth, we support Okta as IdP:

JWT

For JWT, we support Auth0, Keycloak, Microsoft Azure AD, Microsoft Azure AD B2C, and Okta:

Note Down Docker Compose YAML file

After clicking the Create button, if the system passes configuration validation, you will see the screen similar to the one below. Step 1 and Step 2 are meant to help you to download our Datawiza Access Proxy image, but the most important part is step 3. In this sample YAML file, you will find a pre-created pair of PROVISIONING_KEY and PROVISIONING_SECRET. Make sure to copy or note down this YAML file, as you will need to use it later to run our Docker image using the docker-compose command. Please note that this file is specially for the Docker environment. If you are looking for Kubernetes-specific instructions, visit Deploy DAP with Kubernetes.

What is Next

Great! Now that you have learned how to create a deployment, configure an application, and set up the IdP on the Datawiza Cloud Management Console (DCMC), as well as obtained the Docker Compose file with the PROVISIONING_KEY and PROVISIONING_SECRET for Datawiza Access Proxy, you can proceed to deploy Datawiza Access Proxy. Please follow the instructions provided in the Deploy Datawiza Access Proxy guide to continue.