# Scopes

Client scopes define the level of access or permissions that a user or application has when interacting with a client. Scopes are used to segment functionalities and data, allowing fine-grained control over what actions a user can perform. 

1. Open the Admin Console.
2. Look for the Open Id Connect Setting section in the left-hand menu.
3. Within the Open Id Connect Setting section, click on the **Scopes** tab.

<figure><img src="/files/77cYPTriPXDJWkrxvwtG" alt=""><figcaption></figcaption></figure>

### Create Scopes&#x20;

Users have the option to define a scope by providing specific details, assigning a unique scope key, selecting a security level, and tailoring it to their individual preferences.&#x20;

1. Open the Admin Console.
2. In the left-hand menu, navigate to Open Id Connect Setting and then select Create **Scopes.**

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

### <mark style="color:blue;">Scope Details</mark>&#x20;

**Scope Key**&#x20;

* The unique key to identify the scope using a canonical representation for the key-value pair (refer to the API definition) or a single key without a value.&#x20;

**Security Level**

* Choose either Public or Confidential for limited access to data, fields, or services of the app that require admin verification.&#x20;

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

&#x20;**Save**&#x20;

* Click **Save** to confirm and complete the new creation process.&#x20;

**Cancel**&#x20;

* Click **Cancel** to discard and exit the new creation process.&#x20;

### **Security Level**&#x20;

**1.Public Security Level**&#x20;

* Scopes configured with the **public** security level grant open access to their content. Anyone, regardless of authorization, can view and engage with the information contained within.&#x20;
* This accessibility makes **public** security suitable for sharing information widely, enabling collaboration and engagement among a broad audience.&#x20;

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

**2.Confidential Security Level**&#x20;

* In contrast, scopes set to the **confidential** security level prioritize data protection.&#x20;
* Only individuals or groups with specific permissions are granted access to the content.
* This heightened level of security ensures that sensitive or proprietary information remains accessible only to those who have been authorized, safeguarding it from unauthorized exposure.&#x20;

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

### **Edit Scope Details**&#x20;

<mark style="color:purple;">**Note:**</mark> The Scope Key cannot be changed.&#x20;

1. **Add a Locale**:
   * Navigate to the locale settings in your system. This location may vary depending on the platform or software you are using.
   * Look for an option to "Add" or "Include" a new locale.
   * Select the desired locale you want to add and confirm the addition.
2. **Observe Related Changes**:
   * Once you've added the locale, you will notice that certain changes become visible.
3. **Impact on Scope Presentation and Access**:
   * Understand that this addition will affect how the scope is presented and accessed within the system.
   * Pay attention to any language-specific content or settings that may have been introduced or modified.
   * Review the scope and its content to ensure it aligns with the newly added locale.

<figure><img src="/files/5EGoPUYV2uk7VxO7q2Sq" alt=""><figcaption></figcaption></figure>

&#x20;**Locale Settings**

***Select Locale:*** Allow users to choose the locale for their scopes(e.g., English, French, etc.).&#x20;

***Scope Title:*** The identifier of the scope.&#x20;

***Scope Description:*** A description of the purpose of the scope and why it is used.&#x20;

&#x20;

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

<br>

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

### Delete Scope:

* Users have the power to delete scopes in the system. Deleting a scope removes all its content and settings permanently.&#x20;
* It's a big decision because once a scope is deleted, it can't be brought back.&#x20;
* So, it's important to think carefully before deleting a scope.

<figure><img src="/files/jdb7z3P1cCC7ESRZbwel" alt=""><figcaption></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://authdocs.skill-mine.com/licentio-documentation/settings/open-id-connect-setttings/scopes.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.