> 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/rbac-analyzer/role-usage.md).
# Role Usage
This page provides a comprehensive mapping between departments, job titles, and the roles they have been assigned within BalkanID, along with their respective Role Confidence Scores. These roles are generated through an advanced algorithm that calculates the most relevant roles for each department and job title based on their access patterns and permissions.
### Role Confidence Score
Along with identifying BalkanID roles for RBAC, we calculated the significance of the role for a job title and department (confidence score). In our technical analysis, we aim to discern the importance of roles within job titles and departments, spotlighting those that are prevalent or considered "birthright." Additionally, we want our approach to draw attention to a specific role within a job title and department that warrants closer monitoring to prevent potential security issues, ensure productivity (address any decline in performance) or clean-up due to employee’s lateral or upward movement.
The confidence score is calculated based on 3 factors - department, job title and manager. High scores indicate strong alignment between the roles and the department, job title, manager. Lower scores highlight areas that may require further review.
#### Legend:
* **Green** means greater than equal to 75% of employees with job title & department has access to the role (high confidence).
* **Orange** means between greater than equal to 50% and less than 75% of employees with a job title & department has access to the role (medium confidence).
* **Red** means more than equal to 25% and less than 50% of employees with a job title and department has access to the role (low confidence).
**To improve confidence scores:**
* For roles with lower confidence scores, review the associated permissions and compare them with the actual needs of the department or job title.
* Adjust role assignments as necessary to ensure that each role accurately reflects the permissions required for the specific functions of the department or job title.
* Regularly update the roles and their associated permissions based on evolving organizational needs and feedback.
---
# 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:
```
GET https://docs.balkan.id/rbac-analyzer/role-usage.md?ask=
```
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.