> For the complete documentation index, see [llms.txt](https://docs.balkan.id/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.balkan.id/lifecycle-management/access-requests/new-connection-access-request.md).

# New connection access request

The New Connection Access Request System offers three primary functions:

* **Connection Creation**
* **Connection Assignment**
* **Connection Deletion**

Each function can be easily accessed through a simple selection process using radio buttons on our interface. Detailed steps on how to perform each action are provided below.

### **Connection Creation** <a href="#id-01htydy5vvtn6717azy1ttzsa0" id="id-01htydy5vvtn6717azy1ttzsa0"></a>

Creating a new connection is a straightforward process that allows you to add connections like groups, roles, or policies to your chosen applications efficiently.

**Select Creation:** Choose the "Creation" radio button to initiate the connection creation process.\
**Choose an Application:** Select the application where you want to establish a new connection.

<figure><img src="/files/IZ2gVO8a89MicBii1Yqg" alt=""><figcaption></figcaption></figure>

**Fill the Payload:** Upon selecting an application, a visual (payload) form will appear on the page. Complete this form with the necessary information to create the new connection.

<figure><img src="/files/KnTZmEgKUnJ5s3FTTGk4" alt=""><figcaption></figcaption></figure>

**Preview Your Request:** After filling out the form, proceed to the next page to preview your request. This ensures that all provided information is correct.

<figure><img src="/files/dPr8yJlhQEHxFkuEUu08" alt=""><figcaption></figcaption></figure>

**Create Request:** Click the "Create Request" button. Your request will be submitted for approval. The request will be visible in the my task page of the reviewer.<br>

<figure><img src="/files/en5b37SHfJuqeYxHG0YY" alt=""><figcaption></figcaption></figure>

**Approval and Verification:** Once approved(from the my task page of the reviewer), the connection will be added to the selected application. You can verify the addition by checking within the respective application.

<figure><img src="/files/KWTsA6JIGAusxyFCWF0T" alt=""><figcaption></figcaption></figure>

### **Connection Assignment** <a href="#id-01htydy5vvwt4805xs4ab2gjm7" id="id-01htydy5vvwt4805xs4ab2gjm7"></a>

The assignment function allows you to grant or revoke access to various resources and connections for an existing connection.

**Select Provisioning option:** Choose a configuring option.\
**Select Assignment:** Choose the "Assignment" radio button to begin the process of assigning resources to a connection.

**Select Application and Connection Name:** Choose the application and then select the connection you wish to assign resources to.

<figure><img src="/files/Ge75kE58q9WMRuIm0iR8" alt=""><figcaption></figcaption></figure>

**Configure Grants and Revokes:** On selection of connection name, you will see a table where you can grant/revoke accesses. Select the required access to grant/revoke for the selected connection.

* **Grants:** Specify the access rights you wish to grant to the connection.
* **Revokes:** Specify the access rights you wish to revoke from the connection.

```json
{
  "grants": [
    {
      "type": "<type_of_connection_or_resource>",
      "source_name": "<name_of_the_entity>",
      "source_id": "<id_of_the_entity"
    }
  ],
  "revokes": [ 
    {
      "type": "<type_of_connection_or_resource>",
      "source_name": "<name_of_the_entity>",
      "source_id": "<id_of_the_entity>"
    } 
  ]
}
```

**Preview and Create Request:** Like the creation process, preview your request on the next page and then click on "Create Request" to submit it for approval. The request will be visible in the my task page of the reviewer.

<figure><img src="/files/aUsACCD5ZbTr3cqpGC5B" alt=""><figcaption></figcaption></figure>

**Approval and Update:** Once approved(from the reviewer's my task page) the connection's assignments within the application will be updated according to your specifications.

<figure><img src="/files/eZNf9GFdd4oYuP5WihXl" alt=""><figcaption></figcaption></figure>

### **Connection Deletion** <a href="#id-01htydy5vvvfqg26496rhxaj3h" id="id-01htydy5vvvfqg26496rhxaj3h"></a>

Deleting a connection removes it from the selected application.

**Select Deletion:** Choose the "Deletion" radio button to initiate the connection deletion process.

<figure><img src="/files/MSDPwX003cxfl12xyL5n" alt=""><figcaption></figcaption></figure>

**Select Application and Connection:** Choose the application and then the connection you wish to delete.

<figure><img src="/files/3FY1sWxHKCUYwlFcJ3FA" alt=""><figcaption></figcaption></figure>

**Preview and Create Request:** Preview your deletion request on the next page and click on "Create Request" to submit it for approva&#x6C;**.**&#x54;he request will be visible in the my task page of the reviewer.

<figure><img src="/files/qtAX9oxowpUSOJLRWc9e" alt=""><figcaption></figcaption></figure>

**Approval and Deletion:** After the request is approved(from the reviewer's my task page),the connection will be deleted from the application as per the Balkan provisioning process.

<figure><img src="/files/EKnxVyZucWLYRQaJp1G4" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.balkan.id/lifecycle-management/access-requests/new-connection-access-request.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
