# Applications

This section explains the procedure to manage your organization's applications.

Applications are used for API integrations with NVIDIA Run:ai. An application contains a client ID and a client secret. With the client credentials, you can obtain a token as detailed in [API authentication](https://app.gitbook.com/s/b5QLzc5pV7wpXz3CDYyp/getting-started/how-to-authenticate-to-the-api) and use it within subsequent API calls.

Applications are assigned with [access rules ](https://run-ai-docs.nvidia.com/self-hosted/2.20/infrastructure-setup/authentication/accessrules)to manage permissions. For example, application **ci-pipeline-prod** is assigned with a **Researcher** role in **Cluster: A**.

## Applications Table

The Applications table can be found under **Access** in the NVIDIA Run:ai platform.

The Applications table provides a list of all the applications defined in the platform, and allows you to manage them.

![](https://2342309808-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1vISNN7yBSgahrgLlsPz%2Fuploads%2Fgit-blob-39ccbf8ee5a96a0f7cb0cb3453db91d364edce6d%2Fappstable.png?alt=media)

The Applications table consists of the following columns:

| Column         | Description                                        |
| -------------- | -------------------------------------------------- |
| Application    | The name of the application                        |
| Client ID      | The client ID of the application                   |
| Access rule(s) | The access rules assigned to the application       |
| Last login     | The timestamp for the last time the user signed in |
| Created by     | The user who created the application               |
| Creation time  | The timestamp for when the application was created |
| Last updated   | The last time the application was updated          |

### Customizing the Table View

* Filter - Click ADD FILTER, select the column to filter by, and enter the filter values
* Search - Click SEARCH and type the value to search by
* Sort - Click each column header to sort by
* Column selection - Click COLUMNS and select the columns to display in the table
* Download table - Click MORE and then Click Download as CSV. Export to CSV is limited to 20,000 rows.

## Creating an Application

To create an application:

1. Click **+NEW APPLICATION**
2. Enter the application’s **name**
3. Click **CREATE**
4. Copy the **Client ID** and **Client secret** and store them securely
5. Click **DONE**

{% hint style="info" %}
**Note**

The client secret is visible only at the time of creation. It cannot be recovered but can be regenerated.
{% endhint %}

## Adding an Access Rule to an Application

To create an access rule:

1. Select the application you want to add an access rule for
2. Click **ACCESS RULES**
3. Click **+ACCESS RULE**
4. Select a **role**
5. Select a **scope**
6. Click **SAVE RULE**
7. Click **CLOSE**

## Deleting an Access Rule from an Application

To delete an access rule:

1. Select the application you want to remove an access rule from
2. Click **ACCESS RULES**
3. Find the access rule assigned to the user you would like to delete
4. Click on the trash icon
5. Click **CLOSE**

## Regenerating a Client Secret

To regenerate a client secret:

1. Locate the application you want to regenerate its client secret
2. Click **REGENERATE CLIENT SECRET**
3. Click **REGENERATE**
4. Copy the **New client secret** and store it securely
5. Click **DONE**

{% hint style="warning" %}
**Note**

Regenerating a client secret revokes the previous one.
{% endhint %}

## Deleting an Application

1. Select the application you want to delete
2. Click **DELETE**
3. On the dialog, click **DELETE** to confirm

## Using API

Go to the [Applications](https://app.gitbook.com/o/8U8fWH7v8Vg8pc99umXT/s/b5QLzc5pV7wpXz3CDYyp/authentication-and-authorization/applications), [Access rules](https://app.gitbook.com/o/8U8fWH7v8Vg8pc99umXT/s/b5QLzc5pV7wpXz3CDYyp/authentication-and-authorization/access-rules) API reference to view the available actions.