# Applications

<figure><img src="https://762006384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJXOXEifAmpyvNVL1to%2Fuploads%2FlGKhrtW3C17QpVPL2y1U%2FApplications.jpg?alt=media&#x26;token=3a9db568-10db-414c-a954-ec26f8b66dc9" alt=""><figcaption></figcaption></figure>

### What's an Application?

A Secrets Manager Application allows a machine or device to communicate with the Keeper vault, retrieve assigned records and decrypt the data.

Folders are shared to the application, similar to how users are folders are shared to users. This gives the application the capability of accessing and decrypting the records in the folder.

### Creating an Application

From the Keeper Vault, go to Secrets Manager and click on Create Application.

<figure><img src="https://762006384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJXOXEifAmpyvNVL1to%2Fuploads%2F7c4Wl59Aw89PNoAh2jqH%2FScreenshot%202024-12-26%20at%207.04.55%E2%80%AFPM.png?alt=media&#x26;token=6283ebab-de8d-49d7-b12c-4933c7e68a20" alt=""><figcaption></figcaption></figure>

* The Application Name typically represents the use case or environment where it is being used
* The Folder selected is where the application is assigned. An application can be added to any number of shared folders.
* Record permissions give the application either read-only or read/write access to the folder. This is an additional restriction on top of the existing shared folder permissions.
* Click on Generate Access Token to create the first access token, representing the first device
* If you don't plan to set up a device yet, the first access token can be discarded

### Generating a One-Time Access Token

When creating an application, a one-time access token for the first Device is provided. This one-time access token is supplied to the 3rd party system, Keeper Secrets Manager SDK, Keeper Secrets Manager CLI or other device which needs to access information from the vault.

<figure><img src="https://762006384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJXOXEifAmpyvNVL1to%2Fuploads%2Fxd8DfE0CZZHJz6L6fQul%2FScreenshot%202024-12-26%20at%207.05.15%E2%80%AFPM.png?alt=media&#x26;token=934afd24-1594-48eb-a80c-d859d40e419e" alt=""><figcaption><p>One-Time Access Token</p></figcaption></figure>

After creating the application, it is managed from the Secrets Manager screen. You can then assign additional devices or Keeper Gateways.

<figure><img src="https://762006384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJXOXEifAmpyvNVL1to%2Fuploads%2FrGAwVXeftS4nvxQgyt0c%2FScreenshot%202024-12-26%20at%207.05.39%E2%80%AFPM.png?alt=media&#x26;token=63128e5b-44d9-4cb1-86e6-d4251ae3d10f" alt=""><figcaption><p>Managing Applications</p></figcaption></figure>

Applications can be added to new or existing Shared Folders.

<figure><img src="https://762006384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJXOXEifAmpyvNVL1to%2Fuploads%2FmoLDmyO7KrkidzqaItHt%2FScreenshot%202024-12-26%20at%207.07.40%E2%80%AFPM.png?alt=media&#x26;token=961bbddf-b14a-4d82-a0f7-9277548deb51" alt=""><figcaption><p>Creating a Shared Folder</p></figcaption></figure>

Edit the Shared Folder to assign the application.

<figure><img src="https://762006384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJXOXEifAmpyvNVL1to%2Fuploads%2Fj52SOKVTh70KYp2hY5m3%2FScreenshot%202024-12-26%20at%207.08.09%E2%80%AFPM.png?alt=media&#x26;token=d08bcd35-0807-4f66-8c2e-d87da108d34f" alt=""><figcaption><p>Add Application to Shared Folder</p></figcaption></figure>

By assigning the Application to shared folders, the application's devices can send Keeper Secrets Manager API requests to the Keeper vault to access and manage the records assigned. There are many use cases where a device can use Keeper Secrets Manager APIs to communicate with the Keeper vault. Below are a few examples.

* [Secrets Manager CLI](/en/keeperpam/secrets-manager/secrets-manager-command-line-interface.md)
* [Developer SDKs](/en/keeperpam/secrets-manager/developer-sdk-library.md)
* [Integrations](/en/keeperpam/secrets-manager/integrations.md)

### Assigning Gateways to Applications

Keeper Gateways are created and associated to an application. To create a new Gateway, open the application and click on the "Gateways" tab. Select "Provision Gateway" to create a Gateway.

<figure><img src="https://762006384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJXOXEifAmpyvNVL1to%2Fuploads%2FuurHOOWU1OArMPW26bov%2FScreenshot%202024-12-26%20at%207.21.31%E2%80%AFPM.png?alt=media&#x26;token=d09b8ae9-f50f-455d-acd2-4b33947c6c64" alt=""><figcaption><p>Assigning a Gateway to an Application</p></figcaption></figure>

Alternatively, Keeper provides a wizard that creates several components at once, and automatically links everything together. From the main vault screen, select "**Create New**" then "**Gateway**".

<figure><img src="https://762006384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJXOXEifAmpyvNVL1to%2Fuploads%2FMhDrfJxtwD5BfXTzW30Y%2FScreenshot%202024-12-26%20at%207.25.56%E2%80%AFPM.png?alt=media&#x26;token=df02b30a-eccb-4df2-9ecf-dc726ed6da4c" alt=""><figcaption><p>Create a Gateway and associated applications</p></figcaption></figure>

The "Project Name" is used to create a PAM Configuration, Gateway, Application and optionally a set of example folders and records.

<figure><img src="https://762006384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJXOXEifAmpyvNVL1to%2Fuploads%2FD8CTwQzk8HCmJnqzuxac%2FScreenshot%202024-12-26%20at%207.26.16%E2%80%AFPM.png?alt=media&#x26;token=6fd67625-7400-4857-8a6f-b02874a46f6c" alt=""><figcaption><p>Gateway Creation Wizard</p></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.keeper.io/en/keeperpam/privileged-access-manager/getting-started/applications.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
