---
myst:
  html_meta:
    "description lang=en": "Connect Kasm Workspaces to cloud based custom DNS Providers."
    "keywords": "Kasm, DNS, Cloud, AWS, OCI, Digital Ocean, Oracle Cloud, Azure, GCP, Google Compute Engine"
    "property=og:locale": "en_US"
---

# DNS Provider Configs
```{note}
This feature requires a special license. Please contact your Kasm Technologies representative for details.
```

```{figure} /images/compute/dns_create_new.webp
:align: center
**Create New DNS**
```

```{eval-rst}
.. table:: AWS DNS Settings
    :widths: 200

    +-----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
    | **Name**                                | **Description**                                                                                                                                                                                                |
    +-----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
    | **DNS Provider Configs**                | Select an existing config or create a new config. If you select an existing config and change any of the details, those details will be changed for anything using the same DNS Provider config.               |
    +-----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
    | **Provider**                            | Select a provider from AWS, Azure, Digital Ocean, Google Cloud or Oracle Cloud. If you select an existing provider this will be selected automatically.                                                        |
    +-----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
```

## AWS DNS Provider Settings

```{figure} /images/compute/dns_aws.webp
:align: center
**AWS DNS Provider**
```

```{eval-rst}
.. table:: AWS DNS Settings
    :widths: 200

    +-----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
    | **Name**                                | **Description**                                                                                                                                                                                                |
    +-----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
    | **Name**                                | A name to use to identify the config.                                                                                                                                                                          |
    +-----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
    | **Access Key ID**                       | The AWS Access Key used for the AWS API.                                                                                                                                                                       |
    +-----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
    | **Access Key Secret**                   | The AWS Secret Access Key used for the AWS API.                                                                                                                                                                |
    +-----------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+


```

## Azure DNS Provider Settings

```{figure} /images/compute/dns_azure.webp
:align: center
**Azure DNS Provider**
```


```{eval-rst}
.. table:: Azure DNS Provider Settings
    :widths: 75

    +-------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
    | **Name**                      | **Description**                                                                                                                                                                                           |
    +===============================+===========================================================================================================================================================================================================+
    | **Name**                      | A name to use to identify the config.                                                                                                                                                                     |
    +-------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
    | **Subscription ID**           | The Subscription ID for the Azure Account.                                                                                                                                                                |
    |                               | This can be found in the Azure portal by searching for Subscriptions in the search bar in Azure home then selecting the subscription you want to use.                                                     |
    |                               | (e.g :code:`00000000-0000-0000-0000-000000000000`)                                                                                                                                                        |
    +-------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
    | **Resource Group**            | The Resource Group the DNS Zone and/or Virtual Machines belong to (e.g :code:`dev`)                                                                                                                       |
    +-------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
    | **Tenant ID**                 | The Tenant ID for the Azure Account.                                                                                                                                                                      |
    |                               | This can be found in the Azure portal by going to Azure Active Directory using the search bar in Azure home.                                                                                              |
    |                               | (e.g :code:`00000000-0000-0000-0000-000000000000`)                                                                                                                                                        |
    +-------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
    | **Client ID**                 | The Client ID credential used to auth to the Azure Account.                                                                                                                                               |
    |                               | Client ID can be obtained by registering an application within Azure Active Directory.                                                                                                                    |
    |                               | (e.g :code:`00000000-0000-0000-0000-000000000000`)                                                                                                                                                        |
    +-------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
    | **Client Secret**             | The Client Secret credential created with the registered applicaiton in Azure Active Directory. (e.g :code:`abc123`)                                                                                      |
    +-------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
    | **Azure Authority**           | Which Azure authority to use, there are four, Azure Public Cloud, Azure Government, Azure China and Azure Germany.                                                                                        |
    +-------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
    | **Region**                    | The Azure region where the Agents will be provisioned. (e.g :code:`eastus`)                                                                                                                               |
    +-------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
```


## Digital Ocean DNS Provider Settings

```{figure} /images/compute/dns_do.webp
:align: center
**Digital Ocean DNS Provider**
```

```{eval-rst}
.. table:: Digital Ocean DNS Provider Settings
    :widths: 75

    +-----------------------------------+---------------------------------------------------------------------------------------------------------------------------------+
    | Name                              | Description                                                                                                                     |
    +===================================+=================================================================================================================================+
    | **Name**                          | A name to use to identify the config.                                                                                           |
    +-----------------------------------+---------------------------------------------------------------------------------------------------------------------------------+
    | **Token**                         | The token to use to connect to this VM                                                                                          |
    +-----------------------------------+---------------------------------------------------------------------------------------------------------------------------------+

```

## Google Cloud (GCP) DNS Provider Settings

```{figure} /images/compute/dns_google.webp
:align: center
**Google Cloud DNS Provider**
```

```{eval-rst}
.. table:: GCP DNS Provider Settings
    :widths: 75

    +-----------------------------------+---------------------------------------------------------------------------------------------------------------------------------+
    | Name                              | Description                                                                                                                     |
    +===================================+=================================================================================================================================+
    | **Name**                          | A name to use to identify the config.                                                                                           |
    +-----------------------------------+---------------------------------------------------------------------------------------------------------------------------------+
    | **Project**                       | The Google Cloud Project ID (e.g pensive-voice-547511)                                                                          |
    +-----------------------------------+---------------------------------------------------------------------------------------------------------------------------------+
    | **Credentials**                   | The JSON formatted credentials for the service account used to authenticate with GCP:                                           |
    |                                   | `Ref <https://cloud.google.com/iam/docs/creating-managing-service-account-keys#iam-service-account-keys-create-console>`__      |
    +-----------------------------------+---------------------------------------------------------------------------------------------------------------------------------+

```


## Oracle Cloud (OCI) DNS Provider Settings

```{figure} /images/compute/dns_oracle.webp
:align: center
**OCI DNS Provider**
```

```{eval-rst}
.. table:: OCI DNS Provider Settings
    :widths: 75

    +-----------------------------------+---------------------------------------------------------------------------------------------------------------------------------+
    | Name                              | Description                                                                                                                     |
    +===================================+=================================================================================================================================+
    | **Name**                          | A name to use to identify the config.                                                                                           |
    +-----------------------------------+---------------------------------------------------------------------------------------------------------------------------------+
    | **Fingerprint**                   | The public key fingerprint of the authenticated API user. (e.g xx:yy:zz:11:22:33)                                               |
    +-----------------------------------+---------------------------------------------------------------------------------------------------------------------------------+
    | **Tenancy OCID**                  | The Tenancy OCID for the OCI account.  (e.g ocid1.tenancy.oc1..xyz)                                                             |
    +-----------------------------------+---------------------------------------------------------------------------------------------------------------------------------+
    | **Region**                        | The OCI Region name. (e.g us-ashburn-1)                                                                                         |
    +-----------------------------------+---------------------------------------------------------------------------------------------------------------------------------+
    | **Compartment OCID**              | The Compartment OCID where the auto-scaled agents will be placed. (ocid1.compartment.oc1..xyx)                                  |
    +-----------------------------------+---------------------------------------------------------------------------------------------------------------------------------+
    | **User OCID**                     | The OCID of the user to authenticate with the OCI API. (e.g ocid1.user.oc1..xyz)                                                |
    +-----------------------------------+---------------------------------------------------------------------------------------------------------------------------------+
    | **Private Key**                   | The private key (PEM format) of the authenticated API user.                                                                     |
    +-----------------------------------+---------------------------------------------------------------------------------------------------------------------------------+

```