> For the complete documentation index, see [llms.txt](https://authdocs.skill-mine.com/licentio-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://authdocs.skill-mine.com/licentio-documentation/settings/open-id-connect-setttings/scopes.md).

# 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.&#x20;

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="https://1757876898-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNHJr75kSc6HL16U7k3F6%2Fuploads%2Ft0KC1UhqEaKoNrW3nynn%2Fimage.png?alt=media&amp;token=4c5d8343-1f76-413e-b9d3-83a39cbb746b" 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="https://1757876898-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNHJr75kSc6HL16U7k3F6%2Fuploads%2FJszqQUphoOSjn0b7BFTA%2Fimage.png?alt=media&amp;token=ba947854-94ad-4a81-8c5c-d4611dee865d" 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="https://1757876898-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNHJr75kSc6HL16U7k3F6%2Fuploads%2FvlrZ2C6TWpd3jdD1ZmIB%2F3.%20scope%20create.png?alt=media&amp;token=2327ead0-23be-47c3-866f-b05329b0a5d1" 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="https://1757876898-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNHJr75kSc6HL16U7k3F6%2Fuploads%2FqP91FI76ehDxJ3o84h4A%2F4.%20public%20scope.png?alt=media&amp;token=83338b5c-3e9f-4cc5-9aa7-6de7ac38eb16" 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="https://1757876898-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNHJr75kSc6HL16U7k3F6%2Fuploads%2FSsBbxrUBEAka5laCKHho%2F5.%20confidential%20scope.png?alt=media&amp;token=fe1537c4-bb6f-412d-9424-ebd7fe61d70f" 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="https://1757876898-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNHJr75kSc6HL16U7k3F6%2Fuploads%2FOxwVlRZqrTi9F3Gp8RNy%2F6.%20add%20locale.png?alt=media&amp;token=70588f7c-5519-4d1e-9cbb-1b48c89e5c9a" 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="https://1757876898-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNHJr75kSc6HL16U7k3F6%2Fuploads%2FM8ksDuWlNmERS3CqIdwx%2F7.%20locale%20details.png?alt=media&amp;token=a6630aa2-84ec-4cf6-bf43-bf5851039664" alt=""><figcaption></figcaption></figure>

<br>

<figure><img src="https://1757876898-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNHJr75kSc6HL16U7k3F6%2Fuploads%2Fesl6Isk0ZMrxpVy4fvIN%2F8.%20after%20locale%20added.png?alt=media&amp;token=85ea85be-9d68-4c17-8513-c0195ebbb455" 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="https://1757876898-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNHJr75kSc6HL16U7k3F6%2Fuploads%2FZjj8XSeN8IUCjfDcm5kf%2Flast%20Delete%20scope.png?alt=media&amp;token=18095f64-ec32-42fe-85cc-996faace5a22" alt=""><figcaption></figcaption></figure>
