...
Automatic Permissions: Upon creation of a new component unit or configuration type, the system automatically generates Create, ModifyMaintain, and Disable Delete permissions specifically tailored to that type.
Scoped Role Requirement: In order for users to perform actions such as creating, modifying, or disabling components deleting units or configurations of a certain type, they must possess a scoped role that grants the necessary permissions.
Permission Inheritance: Configuration items inherit permissions from the configurations to which they are assigned. This ensures that access rights cascade down appropriately within the hierarchy.
...
Inherited Permissions: Configuration items inherit permissions from the configurations to which they are associated. This means that the access rights granted to configurations are automatically extended to their associated configuration items.
Consistency and Efficiency: By inheriting permissions, configuration items maintain consistency with their parent configurations, streamlining the management of access rights and ensuring efficiency in permission management.
...
Authorization Process
The authorization process in Smartfacts CDCM involves authentication via a central authentication provider, such as Azure AD. Here's how it works:
Authentication: Users are authenticated via a central authentication provider, such as Azure AD.
Token: When accessing CDCM, users carry a token containing tuples or triples defining which roles they own in which scope (spaces or configuration areas).
Role Assignment: The assignment of roles to users is handled outside of Smartfacts CDCM, with support for authorization providers like Azure AD.
So in order to give a user certain permissions these permissions have to be added to a role in CDCM and the token coming from the identity provider has to be configured with the correct scope and the role key for that role (see image below). This page describes the customization options for the token from the identity provider.
...
Managing Roles & Permissions
...
Navigate to Admin Area: Access the admin area of Smartfacts CDCM. (Cogwheel icon at the bottom left in the side menu)
Select Roles & Permissions
Choose an action
Add a new role by clicking on the + Add Role button at the top right
Edit a roles permission by selecting a role from the list
Assign a permission by clicking on the + button in the list of unassigned permissions
Unassign a permission by clicking on the - button in the list of assigned permissions
Permissions can be filtered by access type, unit type and permission type
Example of a configuration
These are examples of scoped roles included in the token provided by the Identitiy Provider.
Give the user a bare minimum role
Create a role which has the permission Space - Read assigned to it. In this example the space has the key spaceOne and the role has the key bm:
...
Go to the IDP and add the attribute
key | value |
|---|---|
cdcm | spaceOne.bm |
On log-in the user receives this scoped role and is now able to read space bm but not the content of any configuration area.
Assign a role to a user for all configuration areas within a space
Create a role which has certain permissions assigned to it. In this example the space has the key spaceOne and the role has the key user:
...
Go to the IDP and add the attribute
key | value |
|---|---|
cdcm | spaceOne.*.user |
On log-in the user receives this scoped role and is now able to work with the assigned permissions in every configuration area.
Assign a role to a user for a specific configuration area
Create a role which has certain permissions assigned to it. In this example the space has the key spaceOne the configuration area has the key caOne and the role has the key ca-admin:
...
Go to the IDP and add the attribute
key | value |
|---|---|
cdcm | spaceOne.caOne.ca-admin |
On log-in the user receives this scoped role and is now able to work with the assigned permissions in this specific configuration area.
Conclusion
Managing scopes, roles, and permissions in Smartfacts CDCM is crucial for maintaining proper access control and security within the configuration management system. By defining roles within specific scopes and assigning appropriate permissions, organizations can ensure that users have the necessary access to perform their tasks effectively while maintaining data security. For detailed instructions on managing roles and permissions, refer to the administration documentation or contact support for assistance.