Build a custom Team dimension, add team attributes, and write attribute, manager, and named-user policy rules that assign the right people to IT security teams automatically as your directory changes in Provisionr.
You have explored the users and attributes that came from your Identity Provider. Those attributes describe your people at the department or large-team level, but they rarely capture the small teams and functions where only a handful of users should have access to a system.This walkthrough builds one example team dimension around Wren Odell’s IT security team — a set of IT Security Engineers — creating the dimension, adding team attributes, and writing the attribute, manager, and named-user rules that decide who belongs to each one.
What you’ll learn
Create a custom Team dimension and add team attributes to it.
Write policy rules that match users by attribute, by manager, and as named users.
Nest one team inside another by using a team attribute as a rule condition.
Stage, review, and activate rules so access is granted only when you are ready.
Reuse a single team definition across every resource that attaches to the attribute.
Prerequisites
A workspace with a completed Okta or Google Workspace integration sync.
The IDs shown below (drdim_…, dratr_…, poset_…, porul_…, and so on) are examples. Your records will have their own IDs. Where a command needs an ID you provide, it is written as an UPPERCASE_TOKEN that you replace with the real value from the previous step’s output.
1. Review dimensions with attributes enabled
1
List the dimensions that have attributes enabled
The profile data on your users comes from your Identity Provider, and that data is usually sourced upstream from your Human Resources Information System. It describes your users at a department level or at a large team level, and it does not always describe the smaller teams and functions where only five or ten users should have access to a system.In this step you will create a dimension of your own to represent those teams, add attributes to it for each team, and write the policy rules that decide who belongs to each one. A user can belong to more than one team at the same time, so a user with a department of IT can also be a member of several security teams simultaneously.The starting point is a list of directory dimensions filtered to the ones that have attributes enabled. These are the dimensions that were created from your Identity Provider data, and there are 7 of them in your directory.
In the Next Step menu, press the ↓ arrow until the radio option reaches Create Dimension and press ENTER/RETURN.
┌ Next Step ──────────────────────────────────────────┐│ ○ I'm all set! ││ ○ Describe/Manage Dimension ││ ○ Create Attribute for Dimension ││ ○ Filter List of Results ││ ○ Edit Column Display Settings ││ ○ Reset List Filters ││ ○ Run Same Command (to get refreshed results) ││ › ● Create Dimension ││ ○ Deprecate (schedule expiration for) Dimension ││ ○ Deactivate Dimension ││ ○ View Soft Deleted (Expired/Deactivated) Records ││ ○ Export Results to File or Spreadsheet ││ ○ View Raw JSON Output ││ ○ Manage a Different Resource │└─────────────────────────────────────────────────────┘
2
Name and confirm the dimension
Name the dimension team and confirm that you are good to go. You can be more descriptive if your organization uses a different word for these groupings, since the wording is your choice.Provisionr responds with Dimension Created Successfully and describes the new record.
┌ Dimension ───────────────────────────────────────────────┐ id drdim_01abc123... state active integration_id integration_type profile_key name Team handle team attributes_enabled true conditions_enabled true expires_after_days 30└──────────────────────────────────────────────────────────┘┌ Child Relationships ─────────────────────────────────────┐ Directory Attributes 0 Audit Logs Parent 0 Audit Logs Record 2 Audit Logs Related 0└──────────────────────────────────────────────────────────┘
4
Review the dimension record
The dimension is created with attributes and conditions enabled and with an expiration default of 30 days, and it has no attributes on it yet.
3. Add an attribute to the dimension
1
Open the Add Attribute option
The dimension holds the teams, and each individual team is an attribute on that dimension. Select the Add Attribute to Dimension option from the Next Step menu.
┌ Next Step ─────────────────────────────────────────────┐│ ○ I'm all set! ││ ○ View/Manage Related Attributes ││ › ● Add Attribute to Dimension ││ ○ Deprecate (schedule expiration for) this Dimension ││ ○ Deactivate this Dimension ││ ○ Create another Dimension ││ ○ Update this Dimension ││ ○ Refresh this Data from the API ││ ○ View Raw JSON Output ││ ○ View Audit Logs for this Dimension ││ ○ List of Dimensions ││ ○ Manage a different resource │└────────────────────────────────────────────────────────┘
IT Security is made up of several teams, so this attribute is for the identity engineering team inside IT Security. Type IT Identity Engineering Team as the Name. The Handle is derived for you as it-identity-eng-team, so you can accept it.You are then asked whether to override the expiration default that the attribute inherits from the dimension. Leave the No option selected and press ENTER/RETURN, then answer Yes to activate the attribute.
┌──────────────────────────────────────────────────────────────────────────────┐You can deactivate a Attribute at any time. You can also use deprecation to havea grace period for changes to be made for users and services before users loseaccess. This is helpful for job role changes where users need a few days orweeks of overlapping access. This is inherited by the dimension unless youoverride it for this Attribute.└──────────────────────────────────────────────────────────────────────────────┘
┌ Override the dimension expires_after_days default (30 days)? ┐│ ○ Yes ││ › ● No │└──────────────────────────────────────────────────────────────┘
4. Review the attribute’s policy ruleset
1
Review the ruleset relationship
The describe output for the new attribute shows a Policy Ruleset alongside the Directory Dimension it belongs to. The attribute has a one-to-one relationship with a ruleset, and that ruleset is what governs who gets access. A user must match at least one of the rules in the ruleset to be added to the attribute.No rules exist yet, so every count on the attribute is zero.
┌ Child Relationships ─────────────────────────────────────┐ Attribute Conditions 0 Attribute Predecessors 0 Policy Rules 0 Manifest Users 0 Qualified Users 0 Staged Users 0 Audit Logs Parent 0 Audit Logs Record 2 Audit Logs Related 0└──────────────────────────────────────────────────────────┘┌ Directory Dimension ─────────────────────────────────────┐ id drdim_01abc123... state active integration_id integration_type profile_key name Team handle team└──────────────────────────────────────────────────────────┘┌ Policy Ruleset ──────────────────────────────────────────┐ id poset_01abc123...└──────────────────────────────────────────────────────────┘
The set of users who match is called the manifest. It works the same way as the manifest for an airplane, a train, or a ship, where the record is a list of who belongs on board rather than a record of how each person got there.
5. List the empty manifest
1
List the ruleset's manifest users
Select the View/Manage Policy Manifest Users option to list the users on the manifest for this ruleset. No rules have been added that would qualify anyone, so the list is empty.
Use Describe/Manage Parent Relationship to move back up from the manifest list to the attribute, then select Create Policy Rule.Each rule carries a role. Users added through a directory attribute are members of that attribute, so accept the Member role. Other resources may offer an owner, a manager, or the other role-based access control roles that those systems support.You are then asked whether to add a justification description. Answer Yes and type a short sentence. This description is what an auditor or a compliance engineer reads to tell at a glance whether the access is a one-off case or expected behavior.
┌──────────────────────────────────────────────────────────────────┐A rule does not have a description by default unless it wasimported during Integration sync for a Dimension Attribute.For custom rules like this, you can (optionally) provide a shortsentence explanation for at-a-glance justification to streamlineuser access reviews.If not set, the rule will be created with a placeholder description.└──────────────────────────────────────────────────────────────────┘┌ Description ─────────────────────────────────────────────────────┐Everyone who reports to this manager is an Identity Engineer.└──────────────────────────────────────────────────────────────────┘
2
Continue into the condition
The rule is created in a staged state and the CLI moves straight on to creating a condition for it.
┌──────────────────────────────────────────────────────────────────────┐Your rule has been created. You can add or remove conditions while therule is in a staged (draft) state. No users will be granted access whilethe rule is in a staged state.You can activate your rule when you are finished adding conditions, havereviewed the list of staged users, and are ready to grant users accessto the Directory Attribute.Active rules are read-only (cannot change conditions).You can duplicate the rule to make a new revision in a staged state.You can deprecate (schedule expiration) or deactivate the existing rule.└──────────────────────────────────────────────────────────────────────┘
┌ Select a Condition Type ───────────┐│ › ● Users attached to an Attribute ││ ○ Users reporting to a Manager ││ ○ Identity Metadata String Match ││ ○ Named User │└────────────────────────────────────┘
7. Add a condition on an existing attribute
1
Choose the attribute condition
Identity Metadata String Match is available, and it is not the option used here. When Provisionr imported your directory data it created an attribute for every value it found, so an attribute for the IT Security Engineer job title already exists and does not need to be rebuilt as a string match.Leave Users attached to an Attribute selected. You are then asked whether to pick the attribute from a user. Select No - Search for Attribute, choose the Title dimension, and choose the IT Security Engineer attribute.
┌ Use a User to select an Attribute? ┐│ ○ Yes - Use Existing User ││ › ● No - Search for Attribute │└────────────────────────────────────┘ You can choose an attribute from an existing user instead of searching all attributes
2
Save the condition
That attribute already has 20 users associated with it. Answer Yes to save the condition, and Provisionr recalculates which users match the rule as it stands.
Rule Conditions┌──────┬───────────┬──────────────────────────────────────────────────┐│ id │ type │ description │├──────┼───────────┼──────────────────────────────────────────────────┤│ qzhk │ attribute │ Users attached to the IT Security Engineer title │└──────┴───────────┴──────────────────────────────────────────────────┘1 Records
3
Review the staged users
The Staged Users table below the conditions lists every user who currently qualifies. A rule can have one or more conditions, and you are asked whether to add another one.
┌ Do you want to add another condition to this rule? ┐│ › ● Yes ││ ○ No │└────────────────────────────────────────────────────┘ Each user must qualify for all conditions to be added as a ruleset user.
Matching the attribute keeps the rule tied to database relationships and cross-reference IDs. If the job title is renamed upstream, the ID does not change and only the display name does, so you only have to change it in one place.
8. Check the filter in a second terminal
1
Filter the directory in a second terminal
Open a second terminal window so you can validate the staged list against your directory without changing anything. Run the user list command, select Filter List of Results, filter by an exact value in a specific field, choose org.title, and select the IT Security Engineer title.
This returns the same 20 users that the attribute reported. Look at the manager.full_name column in that table, which the staged users display does not include. Those users report to several different managers, so they belong to several different teams rather than one. The identity team is only the users who report to Wren Odell, so the rule needs a second condition.
9. Add a condition for users reporting to a manager
1
Add the manager condition
Answer Yes to add another condition and select Users reporting to a Manager. Conditions compound on each other, so a user has to qualify for every condition on the rule.The menu lists the managers in your directory, and the condition is stored against the manager’s ID rather than the manager’s name string. Select Wren Odell and save the changes.
┌ Select a Condition Type ───────────┐│ ○ Users attached to an Attribute ││ › ● Users reporting to a Manager ││ ○ Identity Metadata String Match ││ ○ Named User │└────────────────────────────────────┘
┌────────────────┬──────────────────────────────────┐│ Attribute │ Value │├────────────────┼──────────────────────────────────┤│ policy_rule_id │ porul_01kytqzj8fktrhk0ng75w5q59k ││ type │ manager ││ manager_id │ drusr_01kytjeg1c9xtc1n1vp9dg9t │└────────────────┴──────────────────────────────────┘
2
Review the recalculated manifest
Saving the condition recalculates the draft manifest. The staged list now holds only the users who carry the IT Security Engineer title and report to Wren Odell, which is a smaller list than the title alone produced. There are 9 users reporting to Wren Odell in your directory.
Rule Conditions┌──────┬───────────┬──────────────────────────────────────────────────┐│ id │ type │ description │├──────┼───────────┼──────────────────────────────────────────────────┤│ qzhk │ attribute │ Users attached to the IT Security Engineer title ││ w763 │ manager │ Users that report to Wren Odell │└──────┴───────────┴──────────────────────────────────────────────────┘2 Records
3
Decline another condition
Wren Odell does not appear on this list. The rule qualifies users who report to Wren Odell, not the user who is Wren Odell. A team usually has two rules to start with, one for the users who report to that individual and one for the manager as a named user. An assistant, a dotted-line manager, or someone who covers for the team can be added as a named user in the same way.Answer No to adding another condition so that you can activate this rule and create the second rule separately.
10. Activate the rule
1
Run the activate command
Conditions can be modified while the rule is in a staged state. Staged and draft mean the same thing, and the CLI calls it staged. Once the rule is activated, the conditions are locked and cannot be changed. You can deactivate the rule, deprecate it, or duplicate it into a new staged revision.This is why the justification is captured before activation, so that a rule cannot be approved through change management and then quietly altered afterwards.
prv policy-rule:activate --id=POLICY_RULE_ID
┌ Impact of Decision ──────────────────────────────────────┐You are deploying to production. You shouldknow that:1. After a rule has been activated, you can no longer changethe conditions.2. To make changes, you can duplicate the rule to replacethis rule with a new version.3. Any qualified user that matches all conditions will getaccess immediately to any groups or resources that use thispolicy.└──────────────────────────────────────────────────────────┘
┌ Do you want to activate the Policy Rule? ┐│ › ● Yes ││ ○ No │└──────────────────────────────────────────┘
2
Confirm activation
If you are not ready, you can answer No and run the activate command later. Answering Yes returns Policy Rule Activated Successfully.
Active rules are read-only and their conditions cannot be changed. To make a change, duplicate the rule to create a new revision in a staged state.
11. Review the activated rule
1
Review the rule and its conditions
The rule describe output shows the two conditions and the users they produced. The staged count is now zero and the same users appear as qualified users and as manifest users.
┌ Child Relationships ─────────────────────────────────────┐ Policy Conditions 2 Manifest Users 9 Qualified Users 9 Staged Users 0 Audit Logs Parent 2 Audit Logs Record 2 Audit Logs Related 9└──────────────────────────────────────────────────────────┘┌ Policy Ruleset ──────────────────────────────────────────┐ id poset_01abc123... mode authoritative type directory_attribute expires_after_days 30└──────────────────────────────────────────────────────────┘Condition Records┌──────┬───────────┬─────────────┬──────────────────┬───────────────┬─────────────┐│ id │ type │ profile_key │ profile_operator │ profile_value │ is_imported │├──────┼───────────┼─────────────┼──────────────────┼───────────────┼─────────────┤│ qzhk │ attribute │ title │ │ it-sec-eng │ false ││ w763 │ manager │ full_name │ │ Wren Odell │ false │└──────┴───────────┴─────────────┴──────────────────┴───────────────┴─────────────┘2 Records
Qualified users are the users who match a rule. Manifest users are the users who are on the ruleset. When you have several rules and a user matches more than one of them, only one entry supersedes the others, so the manifest count can be lower than the qualified count in the same way that duplicate records are removed.
12. Add a named user rule
1
Create the second rule
Create a second policy rule on the same ruleset so that Wren Odell is added to the team. Answer Yes to the justification prompt and describe why the manager belongs on the team, then select the Named User condition type.
┌ Select a Condition Type ───────────┐│ ○ Users attached to an Attribute ││ ○ Users reporting to a Manager ││ ○ Identity Metadata String Match ││ › ● Named User │└────────────────────────────────────┘
2
Select the named user
You could name each of the other users individually as well. Rules that are written user by user become difficult to maintain, and keeping the rule tied to data about the user rather than to the user themselves is the reason for the attribute and manager conditions above. Named users cover the circumstances that the data does not, which is usually less than ten percent of the cases.Select Wren Odell from the list of users and save the changes. No population is calculated for this condition, because the user has already been chosen.
Review Your Changes┌───────────────────┬──────────────────────────────────┐│ Attribute │ Value │├───────────────────┼──────────────────────────────────┤│ policy_rule_id │ porul_01kytqzj8fktrhk0ng75w5q59k ││ type │ user ││ directory_user_id │ drusr_01kytjeg1c9xtc1n1vp9dg9t │└───────────────────┴──────────────────────────────────┘
┌ Do you want to activate this rule? ┐│ › ● Yes ││ ○ No │└────────────────────────────────────┘ Wren Odell will be granted access immediately. You can activate later if preferred.
13. Review the rules and the manifest
1
List the rules on the ruleset
Move back up to the attribute and you will see that it now has one more manifest user than the first rule produced on its own. Two different rules justify that access.
Take note of the rule.id column in that table. The row for Wren Odell carries a different rule ID than the rest, because Wren Odell qualified through the named user rule and everyone else qualified through the reporting rule.
14. Find the Team dimension in the full list
1
List all dimensions
Run the dimension list without a filter and the new Team dimension appears alongside the dimensions that came from your Identity Provider.
prv directory-dimension:list
2
Review the Team row
The Team row has no profile_key. The profile key is the name that your provider uses for a field that Provisionr pulls data from, and this data did not come from your provider because you created it. It is a local dimension, so the profile key does not apply.
3
List the dimension's attributes
Select View/Manage Related Attributes to list the attributes on the dimension, where the team you created is shown with its manifest user count.
A user can exist on more than one team, so the next attribute covers a second function inside IT Security. This one is for access request management, and both the identity team and the help desk team will belong to it.The command in the recording was mistyped as prv dimension-attribute:create, with the two resource words transposed, so the CLI returned an error. This is a deliberate example of a common mistake — the correct command is prv directory-attribute:create.
❯ prv dimension-attribute:create No arguments expected, got "dimension-attribute:create".
Run the create command without arguments and you are asked to select the dimension first. The picker lists only the dimensions that have attributes enabled.
prv directory-attribute:create
┌ Select a Dimension ───────────────────────────────────────────────────────────┐│ Keyword from id, integration.vendor, name, handle, count.directory_attributes │├───────────────────────────────────────────────────────────────────────────────┤│ › drdim_01kytqsrgh52atcfzy7gwyqp92 - n/a - Team - team - 1 │└───────────────────────────────────────────────────────────────────────────────┘ Enter a keyword and/or use ↑ and ↓ arrow keys. Press RETURN to select a list option.
2
Name and activate the attribute
Choose the Team dimension, name the attribute IT Security Access Request Handlers, accept the derived handle of it-sec-access-request-handlers, decline the expiration override, and activate it.
16. Describe the new attribute
1
Review the attribute layout
The describe output has the same layout as the first attribute. It sits on the Team dimension, it has a Policy Ruleset of its own, and every user count is zero until you add a rule.
The first rule used the job title attribute as a condition. A team attribute can be used the same way, so this rule nests one team inside another. Select Create Policy Rule, add a justification such as the identity engineering team helping with access requests, and choose Users attached to an Attribute.Select No - Search for Attribute, choose the Team dimension, and choose the IT Identity Engineering Team attribute.
┌ Select a Directory Attribute ─────────────────────────────────────────────────────────────┐│ Keyword from id, integration.vendor, dimension.handle, name, handle, count.manifest_users │├───────────────────────────────────────────────────────────────────────────────────────────┤│ › dratr_… - n/a - team - It Identity Engineering Team - it-identity-eng-team │└───────────────────────────────────────────────────────────────────────────────────────────┘ These options have not been filtered based on the conditional users.
2
Review the staged list
Every user on that team is added to the staged list for this rule, including the manager who qualified through the named user rule. The users were inherited from the upstream attribute, and when that attribute changes the change carries through to everything downstream that uses it.
Rule Conditions┌──────┬───────────┬─────────────────────────────────────────────────────────┐│ id │ type │ description │├──────┼───────────┼─────────────────────────────────────────────────────────┤│ cmn0 │ attribute │ Users attached to the It Identity Engineering Team team │└──────┴───────────┴─────────────────────────────────────────────────────────┘1 Records
3
Activate the rule
Answer No to adding another condition and activate the rule.
The same approach applies to any other resource that you attach to an attribute, such as an application in your Identity Provider, a Google Group, a Slack group, or a GitLab group. You define the team once and reuse it.
18. Reach the command menu
1
Open the menu after the error
Selecting Manage a different resource from the Next Step menu returned an error in the recording. The command that option calls has been renamed, so run prv menu in your terminal to reach the same place.
ERROR Command "wizard" is not defined.
prv menu
2
Navigate the menu
The menu walks you down a namespace, a resource, and an action. Choose Provisionr Directory, then Directory Attribute, then Create a Custom Directory Attribute.
19. Create the helpdesk team attribute
1
Create and activate the attribute
Create the third attribute on the Team dimension, name it IT Security Helpdesk Team, accept the handle of it-sec-helpdesk-team, decline the expiration override, and activate it.
2
Check the titles in the second terminal
The users for this team are not known yet, so use the second terminal to look at the titles first. Reset the filters from earlier, filter by an exact value in the org.title field, and type part of the title into the search row.
┌ Filter by Directory User ┐│ it sec │├──────────────────────────┤│ IT Security Engineer │└──────────────────────────┘ Enter a keyword and/or use ↑ and ↓ arrow keys. Press RETURN to select a list option.
Some organizations use generic job titles and some use specific ones, so it is worth checking whether a separate help desk title exists. In this directory there is no help desk title, and every one of these users carries the IT Security Engineer title.
20. Select an attribute from an existing user
1
Create the rule from an existing user
Create a policy rule on the helpdesk attribute with a justification such as helpdesk engineers having access to their own team, then select Users attached to an Attribute again.This time answer Yes - Use Existing User. Choose a user who already holds the IT Security Engineer title, and the attribute picker lists only the attributes that are on that user.
┌ Use a User to select an Attribute? ┐│ › ● Yes - Use Existing User ││ ○ No - Search for Attribute │└────────────────────────────────────┘ You can choose an attribute from an existing user instead of searching all attributes
┌ Select a Directory Attribute ─────────────────────────────────────────────────────────────┐│ Keyword from id, integration.vendor, dimension.handle, name, handle, count.manifest_users │├───────────────────────────────────────────────────────────────────────────────────────────┤│ › dratr_01kytjhqrqqx8zmczjtpmampy9 - n/a - title - IT Security Engineer - it-sec-eng │└───────────────────────────────────────────────────────────────────────────────────────────┘ These options are filtered based on the selected user.
2
Add the manager condition
Choose the job title attribute and save the changes. This returns the same 20 users as before, so add a second condition for Users reporting to a Manager and select a different manager from that list. Save the changes, answer No to adding another condition, and activate the rule.
21. Add a named user rule for the helpdesk team
1
Create another rule for the manager
Select Create another Policy Rule to add the manager. The role picker shows the member role for the directory attribute, and from there the flow is the one you used for the first team.
┌ Select a Role for this Rule ────────────────────┐│ › porol_… - directory_attribute - member - true │└─────────────────────────────────────────────────┘
2
Add the named user condition
Add a justification, select Named User, choose the manager, and save the changes.
3
Review the manifest
Move back up to the attribute and the manifest count covers both rules. The users who report to that manager and hold the IT Security Engineer title are on the manifest through the first rule, and the manager is on it through the second.
The access request handlers team was created before the helpdesk team existed, so the helpdesk team can now be added to it. List the attributes across every dimension, select Describe/Manage Attribute, and search for the attribute by keyword.
prv directory-attribute:list
┌ Search for Attribute ──────────────────────────────────────────────────────────────────────────────┐│ access │├────────────────────────────────────────────────────────────────────────────────────────────────────┤│ › dratr_… - n/a - team - It Security Access Request Handlers - it-sec-access-request-handlers - 10 │└────────────────────────────────────────────────────────────────────────────────────────────────────┘ Enter a keyword and/or use ↑ and ↓ arrow keys. Press RETURN to select a list option.
23. Add a rule to an existing attribute
1
Create the rule on the access request attribute
From the attribute, select Create Policy Rule, add a justification such as the help desk handling access requests, and choose Users attached to an Attribute followed by No - Search for Attribute.Select the Team dimension first, which now reports three attributes, and then select the IT Security Helpdesk Team attribute with its six manifest users. Read the results in the picker before you press ENTER/RETURN, since the dimension is selected before the attribute.
Review Your Changes┌────────────────────────┬──────────────────────────────────┐│ Attribute │ Value │├────────────────────────┼──────────────────────────────────┤│ policy_rule_id │ porul_01kytqzj8fktrhk0ng75w5q59k ││ type │ attribute ││ directory_attribute_id │ dratr_… │└────────────────────────┴──────────────────────────────────┘
2
Save the changes
Save the changes. The helpdesk users are now mapped to both teams, and the helpdesk attribute is the source of truth for who they are.
24. Review the rule activation prompt
1
Review the activation prompt
Answer No to adding another condition and the CLI presents the activation prompt for the new rule.
┌ Activating the Rule ─────────────────────────────────────┐Activation will immediately add correspondingpolicy user(s) manifest and grant access.If you do not want to grant access, keep the rulestaged and activate later using policy-rule:activate.└──────────────────────────────────────────────────────────┘
┌ Do you want to activate the rule? ┐│ › ● Yes - Activate ││ ○ No - Staged for later │└───────────────────────────────────┘
2
Activate later if needed
In the recording this prompt was cancelled and the rule was left staged. You can activate a staged rule at any time by running the activate command with the rule ID.
prv policy-rule:activate --id=POLICY_RULE_ID
Was this page helpful?
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Provisionr","colors":{"primary":"#d946ef","light":"#d946ef","dark":"#d946ef"},"logo":{"light":"https://mintcdn.com/provisionr/5ukSD9JI1H_kpmU4/logo/light.svg?fit=max\u0026auto=format\u0026n=5ukSD9JI1H_kpmU4\u0026q=85\u0026s=6dc390c4a465580ff27f8fe8d49a11fc","dark":"https://mintcdn.com/provisionr/5ukSD9JI1H_kpmU4/logo/dark.svg?fit=max\u0026auto=format\u0026n=5ukSD9JI1H_kpmU4\u0026q=85\u0026s=f625db342df2b8e7f8a556e48af38b72"},"favicon":"https://mintcdn.com/provisionr/9LyziSRkPeMlxOSc/favicon.png?fit=max\u0026auto=format\u0026n=9LyziSRkPeMlxOSc\u0026q=85\u0026s=8b0e87185aa48df7f1a68a2c0fd8e328","api":{"playground":{"display":"simple"},"examples":{"languages":["curl","powershell","python","laravel","javascript"]}},"navbar":{"links":[],"primary":{"type":"button","label":"Workspace HQ","href":"https://hq.provisionr.io"}},"footer":{"socials":{"website":"https://provisionr.io","slack":"https://community.provisionr.io","x":"https://x.com/provisionr_io","linkedin":"https://www.linkedin.com/company/provisionr-io","github":"https://github.com/provisionr-io","youtube":"https://www.youtube.com/@provisionr"}},"fonts":{"heading":{"family":"IBM Plex Sans"},"body":{"family":"IBM Plex Sans"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Documentation","icon":"file-lines","href":"https://docs.provisionr.io"},{"anchor":"Workspace HQ","icon":"server","href":"https://hq.provisionr.io"},{"anchor":"Slack Community","icon":"slack","href":"https://community.provisionr.io"},{"anchor":"Support Ticket","icon":"comments","href":"https://docs.provisionr.io/support/help"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"provisionr","hasAudioNarration":false,"actualSubdomain":"provisionr","customDomains":["docs.provisionr.io"],"gitSource":{"type":"github","owner":"provisionr-io","repo":"doc","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6afa11cdf773a48258659ef4","clientVersion":"0.0.4160","searchFilterCounts":[{"language":"default","tag":"API Endpoints","count":153},{"language":"default","tag":"CLI Commands","count":151},{"language":"default","tag":"Endpoints","count":149},{"language":"default","tag":"Commands","count":144},{"language":"default","tag":"Runbooks","count":21},{"language":"default","tag":"Billing","count":20},{"language":"default","tag":"Why Provisionr","count":19},{"language":"default","tag":"Workforce Identity Foundations","count":16},{"language":"default","tag":"Concepts","count":13},{"language":"default","tag":"Coming Soon","count":13}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":"@import url('https://googleapis.com');.prose,.prose p,.prose li,.prose ul,.prose ol,.prose h1,.prose h2,.prose h3,.prose h4{line-height:1.6!important}.prose :where(h2):not(:where([class~=not-prose],[class~=not-prose] *)){margin-top:1.5em}.code-block{margin-bottom:1.25rem!important}.steps{margin-top:1.5rem!important}code,pre,kbd,samp,.token{font-family:'IBM Plex Mono', monospace!important;line-height:1.1rem}kbd{margin-left:3px;margin-right:3px;padding-top:0.1em!important;padding-bottom:0.1em!important;font-weight:600!important}img.nav-logo{height:1.75rem!important}.mintlify-container .some-content-class{max-width:1600px!important;width:90%!important}.styled-feature-list{list-style:none;padding:0;margin:0}.styled-feature-list .group-title{display:flex;align-items:center;gap:0.5rem;font-weight:600;font-size:0.95rem;color:var(--primary);margin-bottom:0.5rem;padding:0.25rem 0}.styled-feature-list,.styled-feature-list ul,.styled-feature-list li{list-style:none!important;list-style-type:none!important}.styled-feature-list>li{margin-left:0!important;padding-left:0!important;list-style:none!important;list-style-type:none!important}.styled-feature-list>li::before,.styled-feature-list>li::marker{content:none!important;display:none!important}.styled-feature-list .group-items{margin-left:0!important;padding-left:0!important;margin-bottom:1rem}.styled-feature-list .group-items .feature-item{list-style:none!important;list-style-type:none!important}.styled-feature-list .group-items .feature-item::before{content:none!important;display:none!important}.styled-feature-list .group-items .feature-item::marker{content:none!important;display:none!important}.styled-feature-list .feature-item{display:flex;align-items:center;gap:0.5rem;padding:0.25rem 0;font-size:0.875rem;line-height:1.5;background:transparent!important}.styled-feature-list .feature-item:hover{background:transparent!important}.styled-feature-list .feature-item i{color:#22c55e;width:1rem;flex-shrink:0}.styled-feature-list .feature-item.highlight{background-color:rgba(217, 70, 239, 0.1)!important;border-radius:4px;padding:0.375rem 0.5rem}.styled-feature-list .feature-item.highlight:hover{background-color:rgba(217, 70, 239, 0.1)!important}.styled-feature-list .feature-item.highlight i{color:var(--primary)}.styled-feature-list .badge{font-size:0.7rem;padding:0.125rem 0.375rem;border-radius:9999px;background-color:#6366f1;color:white;font-weight:500;margin-left:auto}table td{min-width:10px!important}"}],"page":{"pagePath":"runbooks/orientation/it","slug":"/runbooks/orientation/it","pageMetadata":{"title":"Create IT Team Attributes","description":"Build a custom Team dimension, add team attributes, and write attribute, manager, and named-user policy rules that assign the right people to IT security teams automatically as your directory changes in Provisionr.","icon":"rebel","href":"/runbooks/orientation/it"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Build a custom Team dimension, add team attributes, and write attribute, manager, and named-user policy rules that assign the right people to IT security teams automatically as your directory changes in Provisionr.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Note,Step,Steps,Tip,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`You have explored the users and attributes that came from your Identity Provider. Those attributes describe your people at the department or large-team level, but they rarely capture the small teams and functions where only a handful of users should have access to a system.`}),`\n`,_jsxs(_components.p,{children:[`This walkthrough builds one example team dimension around `,_jsx(_components.strong,{children:`Wren Odell`}),`’s IT security team — a set of `,_jsx(_components.code,{children:`IT Security Engineer`}),`s — creating the dimension, adding team attributes, and writing the attribute, manager, and named-user rules that decide who belongs to each one.`]}),`\n`,_jsx(Heading,{level:`2`,id:`what-you’ll-learn`,children:`What you’ll learn`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Create a custom Team dimension and add team attributes to it.`}),`\n`,_jsx(_components.li,{children:`Write policy rules that match users by attribute, by manager, and as named users.`}),`\n`,_jsx(_components.li,{children:`Nest one team inside another by using a team attribute as a rule condition.`}),`\n`,_jsx(_components.li,{children:`Stage, review, and activate rules so access is granted only when you are ready.`}),`\n`,_jsx(_components.li,{children:`Reuse a single team definition across every resource that attaches to the attribute.`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`prerequisites`,children:`Prerequisites`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`A workspace with a completed Okta or Google Workspace integration sync.`}),`\n`,_jsxs(_components.li,{children:[`The `,_jsx(_components.code,{children:`prv`}),` CLI `,_jsx(_components.a,{href:`/cli/workspace/v1/intro/auth`,children:`authenticated`}),` to your workspace.`]}),`\n`,_jsxs(_components.li,{children:[`Familiarity with `,_jsx(_components.a,{href:`/runbooks/orientation/attributes`,children:`exploring users and attributes`}),`.`]}),`\n`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`The IDs shown below (`,_jsx(_components.code,{children:`drdim_…`}),`, `,_jsx(_components.code,{children:`dratr_…`}),`, `,_jsx(_components.code,{children:`poset_…`}),`, `,_jsx(_components.code,{children:`porul_…`}),`, and so on) are examples. Your records will have their own IDs. Where a command needs an ID you provide, it is written as an `,_jsx(_components.code,{children:`UPPERCASE_TOKEN`}),` that you replace with the real value from the previous step’s output.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`1-review-dimensions-with-attributes-enabled`,children:`1. Review dimensions with attributes enabled`}),`\n`,_jsx(Steps,{children:_jsxs(Step,{title:`List the dimensions that have attributes enabled`,children:[_jsx(_components.p,{children:`The profile data on your users comes from your Identity Provider, and that data is usually sourced upstream from your Human Resources Information System. It describes your users at a department level or at a large team level, and it does not always describe the smaller teams and functions where only five or ten users should have access to a system.`}),_jsx(_components.p,{children:`In this step you will create a dimension of your own to represent those teams, add attributes to it for each team, and write the policy rules that decide who belongs to each one. A user can belong to more than one team at the same time, so a user with a department of IT can also be a member of several security teams simultaneously.`}),_jsx(_components.p,{children:`The starting point is a list of directory dimensions filtered to the ones that have attributes enabled. These are the dimensions that were created from your Identity Provider data, and there are 7 of them in your directory.`}),_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`prv`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` directory-dimension:list`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --where=attributes_enabled=true`})]}),`\n`]})})})]})}),`\n`,_jsx(Heading,{level:`2`,id:`2-create-the-team-dimension`,children:`2. Create the Team dimension`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Open the Create Dimension option`,children:[_jsxs(_components.p,{children:[`In the `,_jsx(_components.strong,{children:`Next Step`}),` menu, press the `,_jsx(`kbd`,{children:`↓`}),` arrow until the radio option reaches `,_jsx(_components.strong,{children:`Create Dimension`}),` and press `,_jsx(`kbd`,{children:`ENTER`}),`/`,_jsx(`kbd`,{children:`RETURN`}),`.`]}),_jsx(CodeBlock,{numberOfLines:`17`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`17`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`┌ Next Step ──────────────────────────────────────────┐`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ I'm all set! │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ Describe/Manage Dimension │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ Create Attribute for Dimension │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ Filter List of Results │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ Edit Column Display Settings │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ Reset List Filters │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ Run Same Command (to get refreshed results) │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ › ● Create Dimension │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ Deprecate (schedule expiration for) Dimension │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ Deactivate Dimension │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ View Soft Deleted (Expired/Deactivated) Records │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ Export Results to File or Spreadsheet │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ View Raw JSON Output │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ Manage a Different Resource │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`└─────────────────────────────────────────────────────┘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})]}),_jsxs(Step,{title:`Name and confirm the dimension`,children:[_jsxs(_components.p,{children:[`Name the dimension `,_jsx(_components.code,{children:`team`}),` and confirm that you are good to go. You can be more descriptive if your organization uses a different word for these groupings, since the wording is your choice.`]}),_jsxs(_components.p,{children:[`Provisionr responds with `,_jsx(_components.code,{children:`Dimension Created Successfully`}),` and describes the new record.`]})]}),_jsxs(Step,{title:`Describe the new dimension`,children:[_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`prv`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` directory-dimension:describe`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --id=TEAM_DIMENSION_ID`})]}),`\n`]})})}),_jsx(CodeBlock,{numberOfLines:`20`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`20`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`┌ Dimension ───────────────────────────────────────────────┐`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` id drdim_01abc123...`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` state active`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` integration_id`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` integration_type`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` profile_key`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` name Team`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` handle team`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` attributes_enabled true`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` conditions_enabled true`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` expires_after_days 30`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`└──────────────────────────────────────────────────────────┘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`┌ Child Relationships ─────────────────────────────────────┐`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` Directory Attributes 0`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` Audit Logs Parent 0`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` Audit Logs Record 2`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` Audit Logs Related 0`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`└──────────────────────────────────────────────────────────┘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})]}),_jsx(Step,{title:`Review the dimension record`,children:_jsx(_components.p,{children:`The dimension is created with attributes and conditions enabled and with an expiration default of 30 days, and it has no attributes on it yet.`})})]}),`\n`,_jsx(Heading,{level:`2`,id:`3-add-an-attribute-to-the-dimension`,children:`3. Add an attribute to the dimension`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Open the Add Attribute option`,children:[_jsxs(_components.p,{children:[`The dimension holds the teams, and each individual team is an attribute on that dimension. Select the `,_jsx(_components.strong,{children:`Add Attribute to Dimension`}),` option from the `,_jsx(_components.strong,{children:`Next Step`}),` menu.`]}),_jsx(CodeBlock,{numberOfLines:`15`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`15`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`┌ Next Step ─────────────────────────────────────────────┐`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ I'm all set! │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ View/Manage Related Attributes │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ › ● Add Attribute to Dimension │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ Deprecate (schedule expiration for) this Dimension │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ Deactivate this Dimension │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ Create another Dimension │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ Update this Dimension │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ Refresh this Data from the API │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ View Raw JSON Output │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ View Audit Logs for this Dimension │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ List of Dimensions │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ Manage a different resource │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`└────────────────────────────────────────────────────────┘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`prv`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` directory-attribute:create`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --directory_dimension_id=TEAM_DIMENSION_ID`})]}),`\n`]})})})]}),_jsxs(Step,{title:`Name and activate the attribute`,children:[_jsxs(_components.p,{children:[`IT Security is made up of several teams, so this attribute is for the identity engineering team inside IT Security. Type `,_jsx(_components.code,{children:`IT Identity Engineering Team`}),` as the Name. The Handle is derived for you as `,_jsx(_components.code,{children:`it-identity-eng-team`}),`, so you can accept it.`]}),_jsxs(_components.p,{children:[`You are then asked whether to override the expiration default that the attribute inherits from the dimension. Leave the `,_jsx(_components.strong,{children:`No`}),` option selected and press `,_jsx(`kbd`,{children:`ENTER`}),`/`,_jsx(`kbd`,{children:`RETURN`}),`, then answer `,_jsx(_components.strong,{children:`Yes`}),` to activate the attribute.`]}),_jsx(CodeBlock,{numberOfLines:`8`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`8`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`┌──────────────────────────────────────────────────────────────────────────────┐`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`You can deactivate a Attribute at any time. You can also use deprecation to have`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`a grace period for changes to be made for users and services before users lose`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`access. This is helpful for job role changes where users need a few days or`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`weeks of overlapping access. This is inherited by the dimension unless you`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`override it for this Attribute.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`└──────────────────────────────────────────────────────────────────────────────┘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsx(CodeBlock,{numberOfLines:`5`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`┌ Override the dimension expires_after_days default (30 days)? ┐`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ Yes │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ › ● No │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`└──────────────────────────────────────────────────────────────┘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`4-review-the-attribute’s-policy-ruleset`,children:`4. Review the attribute’s policy ruleset`}),`\n`,_jsx(Steps,{children:_jsxs(Step,{title:`Review the ruleset relationship`,children:[_jsx(_components.p,{children:`The describe output for the new attribute shows a Policy Ruleset alongside the Directory Dimension it belongs to. The attribute has a one-to-one relationship with a ruleset, and that ruleset is what governs who gets access. A user must match at least one of the rules in the ruleset to be added to the attribute.`}),_jsx(_components.p,{children:`No rules exist yet, so every count on the attribute is zero.`}),_jsx(CodeBlock,{numberOfLines:`26`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`26`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`┌ Child Relationships ─────────────────────────────────────┐`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` Attribute Conditions 0`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` Attribute Predecessors 0`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` Policy Rules 0`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` Manifest Users 0`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` Qualified Users 0`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` Staged Users 0`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` Audit Logs Parent 0`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` Audit Logs Record 2`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` Audit Logs Related 0`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`└──────────────────────────────────────────────────────────┘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`┌ Directory Dimension ─────────────────────────────────────┐`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` id drdim_01abc123...`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` state active`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` integration_id`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` integration_type`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` profile_key`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` name Team`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` handle team`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`└──────────────────────────────────────────────────────────┘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`┌ Policy Ruleset ──────────────────────────────────────────┐`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` id poset_01abc123...`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`└──────────────────────────────────────────────────────────┘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})]})}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`The set of users who match is called the manifest. It works the same way as the manifest for an airplane, a train, or a ship, where the record is a list of who belongs on board rather than a record of how each person got there.`})}),`\n`,_jsx(Heading,{level:`2`,id:`5-list-the-empty-manifest`,children:`5. List the empty manifest`}),`\n`,_jsx(Steps,{children:_jsxs(Step,{title:`List the ruleset's manifest users`,children:[_jsxs(_components.p,{children:[`Select the `,_jsx(_components.strong,{children:`View/Manage Policy Manifest Users`}),` option to list the users on the manifest for this ruleset. No rules have been added that would qualify anyone, so the list is empty.`]}),_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`prv`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` policy-user:list`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --policy_ruleset_id=POLICY_RULESET_ID`})]}),`\n`]})})}),_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`No Policy User records exist`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})]})}),`\n`,_jsx(Heading,{level:`2`,id:`6-create-the-first-policy-rule`,children:`6. Create the first policy rule`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Create the rule and add a justification`,children:[_jsxs(_components.p,{children:[`Use `,_jsx(_components.strong,{children:`Describe/Manage Parent Relationship`}),` to move back up from the manifest list to the attribute, then select `,_jsx(_components.strong,{children:`Create Policy Rule`}),`.`]}),_jsx(_components.p,{children:`Each rule carries a role. Users added through a directory attribute are members of that attribute, so accept the Member role. Other resources may offer an owner, a manager, or the other role-based access control roles that those systems support.`}),_jsxs(_components.p,{children:[`You are then asked whether to add a justification description. Answer `,_jsx(_components.strong,{children:`Yes`}),` and type a short sentence. This description is what an auditor or a compliance engineer reads to tell at a glance whether the access is a one-off case or expected behavior.`]}),_jsx(CodeBlock,{numberOfLines:`15`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`15`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`┌──────────────────────────────────────────────────────────────────┐`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`A rule does not have a description by default unless it was`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`imported during Integration sync for a Dimension Attribute.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`For custom rules like this, you can (optionally) provide a short`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`sentence explanation for at-a-glance justification to streamline`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`user access reviews.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`If not set, the rule will be created with a placeholder description.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`└──────────────────────────────────────────────────────────────────┘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`┌ Description ─────────────────────────────────────────────────────┐`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Everyone who reports to this manager is an Identity Engineer.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`└──────────────────────────────────────────────────────────────────┘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})]}),_jsxs(Step,{title:`Continue into the condition`,children:[_jsx(_components.p,{children:`The rule is created in a staged state and the CLI moves straight on to creating a condition for it.`}),_jsx(CodeBlock,{numberOfLines:`14`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`14`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`┌──────────────────────────────────────────────────────────────────────┐`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Your rule has been created. You can add or remove conditions while the`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`rule is in a staged (draft) state. No users will be granted access while`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`the rule is in a staged state.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`You can activate your rule when you are finished adding conditions, have`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`reviewed the list of staged users, and are ready to grant users access`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`to the Directory Attribute.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Active rules are read-only (cannot change conditions).`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`You can duplicate the rule to make a new revision in a staged state.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`You can deprecate (schedule expiration) or deactivate the existing rule.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`└──────────────────────────────────────────────────────────────────────┘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`prv`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` policy-condition:create`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --policy_rule_id=POLICY_RULE_ID`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --no_describe`})]}),`\n`]})})}),_jsx(CodeBlock,{numberOfLines:`7`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`┌ Select a Condition Type ───────────┐`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ › ● Users attached to an Attribute │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ Users reporting to a Manager │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ Identity Metadata String Match │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ Named User │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`└────────────────────────────────────┘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`7-add-a-condition-on-an-existing-attribute`,children:`7. Add a condition on an existing attribute`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Choose the attribute condition`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Identity Metadata String Match`}),` is available, and it is not the option used here. When Provisionr imported your directory data it created an attribute for every value it found, so an attribute for the IT Security Engineer job title already exists and does not need to be rebuilt as a string match.`]}),_jsxs(_components.p,{children:[`Leave `,_jsx(_components.strong,{children:`Users attached to an Attribute`}),` selected. You are then asked whether to pick the attribute from a user. Select `,_jsx(_components.strong,{children:`No - Search for Attribute`}),`, choose the Title dimension, and choose the IT Security Engineer attribute.`]}),_jsx(CodeBlock,{numberOfLines:`6`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`┌ Use a User to select an Attribute? ┐`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ Yes - Use Existing User │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ › ● No - Search for Attribute │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`└────────────────────────────────────┘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` You can choose an attribute from an existing user instead of searching all attributes`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})]}),_jsxs(Step,{title:`Save the condition`,children:[_jsxs(_components.p,{children:[`That attribute already has 20 users associated with it. Answer `,_jsx(_components.strong,{children:`Yes`}),` to save the condition, and Provisionr recalculates which users match the rule as it stands.`]}),_jsx(CodeBlock,{numberOfLines:`9`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`9`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Rule Conditions`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`┌──────┬───────────┬──────────────────────────────────────────────────┐`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ id │ type │ description │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`├──────┼───────────┼──────────────────────────────────────────────────┤`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ qzhk │ attribute │ Users attached to the IT Security Engineer title │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`└──────┴───────────┴──────────────────────────────────────────────────┘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`1 Records`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})]}),_jsxs(Step,{title:`Review the staged users`,children:[_jsx(_components.p,{children:`The Staged Users table below the conditions lists every user who currently qualifies. A rule can have one or more conditions, and you are asked whether to add another one.`}),_jsx(CodeBlock,{numberOfLines:`6`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`┌ Do you want to add another condition to this rule? ┐`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ › ● Yes │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ No │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`└────────────────────────────────────────────────────┘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` Each user must qualify for all conditions to be added as a ruleset user.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})]})]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`Matching the attribute keeps the rule tied to database relationships and cross-reference IDs. If the job title is renamed upstream, the ID does not change and only the display name does, so you only have to change it in one place.`})}),`\n`,_jsx(Heading,{level:`2`,id:`8-check-the-filter-in-a-second-terminal`,children:`8. Check the filter in a second terminal`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Filter the directory in a second terminal`,children:[_jsxs(_components.p,{children:[`Open a second terminal window so you can validate the staged list against your directory without changing anything. Run the user list command, select `,_jsx(_components.strong,{children:`Filter List of Results`}),`, filter by an exact value in a specific field, choose `,_jsx(_components.strong,{children:`org.title`}),`, and select the IT Security Engineer title.`]}),_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`prv`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` directory-user:list`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`prv`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` directory-user:list`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --where=org.title=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'IT Security Engineer'`})]}),`\n`]})})})]}),_jsx(Step,{title:`Review the managers`,children:_jsxs(_components.p,{children:[`This returns the same 20 users that the attribute reported. Look at the `,_jsx(_components.code,{children:`manager.full_name`}),` column in that table, which the staged users display does not include. Those users report to several different managers, so they belong to several different teams rather than one. The identity team is only the users who report to Wren Odell, so the rule needs a second condition.`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`9-add-a-condition-for-users-reporting-to-a-manager`,children:`9. Add a condition for users reporting to a manager`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Add the manager condition`,children:[_jsxs(_components.p,{children:[`Answer `,_jsx(_components.strong,{children:`Yes`}),` to add another condition and select `,_jsx(_components.strong,{children:`Users reporting to a Manager`}),`. Conditions compound on each other, so a user has to qualify for every condition on the rule.`]}),_jsx(_components.p,{children:`The menu lists the managers in your directory, and the condition is stored against the manager’s ID rather than the manager’s name string. Select Wren Odell and save the changes.`}),_jsx(CodeBlock,{numberOfLines:`7`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`┌ Select a Condition Type ───────────┐`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ Users attached to an Attribute │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ › ● Users reporting to a Manager │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ Identity Metadata String Match │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ Named User │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`└────────────────────────────────────┘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsx(CodeBlock,{numberOfLines:`8`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`8`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`┌────────────────┬──────────────────────────────────┐`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ Attribute │ Value │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`├────────────────┼──────────────────────────────────┤`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ policy_rule_id │ porul_01kytqzj8fktrhk0ng75w5q59k │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ type │ manager │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ manager_id │ drusr_01kytjeg1c9xtc1n1vp9dg9t │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`└────────────────┴──────────────────────────────────┘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})]}),_jsxs(Step,{title:`Review the recalculated manifest`,children:[_jsx(_components.p,{children:`Saving the condition recalculates the draft manifest. The staged list now holds only the users who carry the IT Security Engineer title and report to Wren Odell, which is a smaller list than the title alone produced. There are 9 users reporting to Wren Odell in your directory.`}),_jsx(CodeBlock,{numberOfLines:`10`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`10`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Rule Conditions`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`┌──────┬───────────┬──────────────────────────────────────────────────┐`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ id │ type │ description │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`├──────┼───────────┼──────────────────────────────────────────────────┤`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ qzhk │ attribute │ Users attached to the IT Security Engineer title │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ w763 │ manager │ Users that report to Wren Odell │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`└──────┴───────────┴──────────────────────────────────────────────────┘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`2 Records`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})]}),_jsxs(Step,{title:`Decline another condition`,children:[_jsx(_components.p,{children:`Wren Odell does not appear on this list. The rule qualifies users who report to Wren Odell, not the user who is Wren Odell. A team usually has two rules to start with, one for the users who report to that individual and one for the manager as a named user. An assistant, a dotted-line manager, or someone who covers for the team can be added as a named user in the same way.`}),_jsxs(_components.p,{children:[`Answer `,_jsx(_components.strong,{children:`No`}),` to adding another condition so that you can activate this rule and create the second rule separately.`]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`10-activate-the-rule`,children:`10. Activate the rule`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Run the activate command`,children:[_jsx(_components.p,{children:`Conditions can be modified while the rule is in a staged state. Staged and draft mean the same thing, and the CLI calls it staged. Once the rule is activated, the conditions are locked and cannot be changed. You can deactivate the rule, deprecate it, or duplicate it into a new staged revision.`}),_jsx(_components.p,{children:`This is why the justification is captured before activation, so that a rule cannot be approved through change management and then quietly altered afterwards.`}),_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`prv`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` policy-rule:activate`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --id=POLICY_RULE_ID`})]}),`\n`]})})}),_jsx(CodeBlock,{numberOfLines:`15`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`15`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`┌ Impact of Decision ──────────────────────────────────────┐`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`You are deploying to production. You should`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`know that:`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`1. After a rule has been activated, you can no longer change`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`the conditions.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`2. To make changes, you can duplicate the rule to replace`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`this rule with a new version.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`3. Any qualified user that matches all conditions will get`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`access immediately to any groups or resources that use this`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`policy.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`└──────────────────────────────────────────────────────────┘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsx(CodeBlock,{numberOfLines:`5`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`┌ Do you want to activate the Policy Rule? ┐`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ › ● Yes │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ No │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`└──────────────────────────────────────────┘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})]}),_jsx(Step,{title:`Confirm activation`,children:_jsxs(_components.p,{children:[`If you are not ready, you can answer `,_jsx(_components.strong,{children:`No`}),` and run the activate command later. Answering `,_jsx(_components.strong,{children:`Yes`}),` returns `,_jsx(_components.code,{children:`Policy Rule Activated Successfully`}),`.`]})})]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Active rules are read-only and their conditions cannot be changed. To make a change, duplicate the rule to create a new revision in a staged state.`})}),`\n`,_jsx(Heading,{level:`2`,id:`11-review-the-activated-rule`,children:`11. Review the activated rule`}),`\n`,_jsx(Steps,{children:_jsxs(Step,{title:`Review the rule and its conditions`,children:[_jsx(_components.p,{children:`The rule describe output shows the two conditions and the users they produced. The staged count is now zero and the same users appear as qualified users and as manifest users.`}),_jsx(CodeBlock,{numberOfLines:`27`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`27`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`┌ Child Relationships ─────────────────────────────────────┐`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` Policy Conditions 2`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` Manifest Users 9`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` Qualified Users 9`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` Staged Users 0`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` Audit Logs Parent 2`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` Audit Logs Record 2`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` Audit Logs Related 9`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`└──────────────────────────────────────────────────────────┘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`┌ Policy Ruleset ──────────────────────────────────────────┐`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` id poset_01abc123...`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` mode authoritative`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` type directory_attribute`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` expires_after_days 30`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`└──────────────────────────────────────────────────────────┘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Condition Records`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`┌──────┬───────────┬─────────────┬──────────────────┬───────────────┬─────────────┐`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ id │ type │ profile_key │ profile_operator │ profile_value │ is_imported │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`├──────┼───────────┼─────────────┼──────────────────┼───────────────┼─────────────┤`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ qzhk │ attribute │ title │ │ it-sec-eng │ false │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ w763 │ manager │ full_name │ │ Wren Odell │ false │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`└──────┴───────────┴─────────────┴──────────────────┴───────────────┴─────────────┘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`2 Records`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})]})}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`Qualified users are the users who match a rule. Manifest users are the users who are on the ruleset. When you have several rules and a user matches more than one of them, only one entry supersedes the others, so the manifest count can be lower than the qualified count in the same way that duplicate records are removed.`})}),`\n`,_jsx(Heading,{level:`2`,id:`12-add-a-named-user-rule`,children:`12. Add a named user rule`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Create the second rule`,children:[_jsxs(_components.p,{children:[`Create a second policy rule on the same ruleset so that Wren Odell is added to the team. Answer `,_jsx(_components.strong,{children:`Yes`}),` to the justification prompt and describe why the manager belongs on the team, then select the `,_jsx(_components.strong,{children:`Named User`}),` condition type.`]}),_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`prv`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` policy-rule:create`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --policy_ruleset_id=POLICY_RULESET_ID`})]}),`\n`]})})}),_jsx(CodeBlock,{numberOfLines:`7`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`┌ Select a Condition Type ───────────┐`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ Users attached to an Attribute │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ Users reporting to a Manager │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ Identity Metadata String Match │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ › ● Named User │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`└────────────────────────────────────┘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})]}),_jsxs(Step,{title:`Select the named user`,children:[_jsx(_components.p,{children:`You could name each of the other users individually as well. Rules that are written user by user become difficult to maintain, and keeping the rule tied to data about the user rather than to the user themselves is the reason for the attribute and manager conditions above. Named users cover the circumstances that the data does not, which is usually less than ten percent of the cases.`}),_jsx(_components.p,{children:`Select Wren Odell from the list of users and save the changes. No population is calculated for this condition, because the user has already been chosen.`}),_jsx(CodeBlock,{numberOfLines:`10`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`10`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Review Your Changes`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`┌───────────────────┬──────────────────────────────────┐`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ Attribute │ Value │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`├───────────────────┼──────────────────────────────────┤`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ policy_rule_id │ porul_01kytqzj8fktrhk0ng75w5q59k │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ type │ user │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ directory_user_id │ drusr_01kytjeg1c9xtc1n1vp9dg9t │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`└───────────────────┴──────────────────────────────────┘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsx(CodeBlock,{numberOfLines:`6`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`┌ Do you want to activate this rule? ┐`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ › ● Yes │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ No │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`└────────────────────────────────────┘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` Wren Odell will be granted access immediately. You can activate later if preferred.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`13-review-the-rules-and-the-manifest`,children:`13. Review the rules and the manifest`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`List the rules on the ruleset`,children:[_jsx(_components.p,{children:`Move back up to the attribute and you will see that it now has one more manifest user than the first rule produced on its own. Two different rules justify that access.`}),_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`prv`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` policy-rule:list`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --policy_ruleset_id=POLICY_RULESET_ID`})]}),`\n`]})})}),_jsx(_components.p,{children:`The rule list shows both rules, each with its own description, its condition count, and its manifest user count.`})]}),_jsxs(Step,{title:`List the manifest users`,children:[_jsx(_components.p,{children:`The list of users on the ruleset shows every user in one table.`}),_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`prv`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` policy-user:list`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --policy_ruleset_id=POLICY_RULESET_ID`})]}),`\n`]})})})]}),_jsx(Step,{title:`Review the rule IDs`,children:_jsxs(_components.p,{children:[`Take note of the `,_jsx(_components.code,{children:`rule.id`}),` column in that table. The row for Wren Odell carries a different rule ID than the rest, because Wren Odell qualified through the named user rule and everyone else qualified through the reporting rule.`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`14-find-the-team-dimension-in-the-full-list`,children:`14. Find the Team dimension in the full list`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`List all dimensions`,children:[_jsx(_components.p,{children:`Run the dimension list without a filter and the new Team dimension appears alongside the dimensions that came from your Identity Provider.`}),_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`prv`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` directory-dimension:list`})]}),`\n`]})})})]}),_jsx(Step,{title:`Review the Team row`,children:_jsxs(_components.p,{children:[`The Team row has no `,_jsx(_components.code,{children:`profile_key`}),`. The profile key is the name that your provider uses for a field that Provisionr pulls data from, and this data did not come from your provider because you created it. It is a local dimension, so the profile key does not apply.`]})}),_jsxs(Step,{title:`List the dimension's attributes`,children:[_jsxs(_components.p,{children:[`Select `,_jsx(_components.strong,{children:`View/Manage Related Attributes`}),` to list the attributes on the dimension, where the team you created is shown with its manifest user count.`]}),_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`prv`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` directory-attribute:list`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --directory_dimension_id=TEAM_DIMENSION_ID`})]}),`\n`]})})})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`15-create-a-second-team-attribute`,children:`15. Create a second team attribute`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Run the create command`,children:[_jsx(_components.p,{children:`A user can exist on more than one team, so the next attribute covers a second function inside IT Security. This one is for access request management, and both the identity team and the help desk team will belong to it.`}),_jsxs(_components.p,{children:[`The command in the recording was mistyped as `,_jsx(_components.code,{children:`prv dimension-attribute:create`}),`, with the two resource words transposed, so the CLI returned an error. This is a deliberate example of a common mistake — the correct command is `,_jsx(_components.code,{children:`prv directory-attribute:create`}),`.`]}),_jsx(CodeBlock,{numberOfLines:`4`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`4`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`❯ prv dimension-attribute:create`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` No arguments expected, got \"dimension-attribute:create\".`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsx(_components.p,{children:`Run the create command without arguments and you are asked to select the dimension first. The picker lists only the dimensions that have attributes enabled.`}),_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`prv`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` directory-attribute:create`})]}),`\n`]})})}),_jsx(CodeBlock,{numberOfLines:`7`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`┌ Select a Dimension ───────────────────────────────────────────────────────────┐`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ Keyword from id, integration.vendor, name, handle, count.directory_attributes │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`├───────────────────────────────────────────────────────────────────────────────┤`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ › drdim_01kytqsrgh52atcfzy7gwyqp92 - n/a - Team - team - 1 │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`└───────────────────────────────────────────────────────────────────────────────┘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` Enter a keyword and/or use ↑ and ↓ arrow keys. Press RETURN to select a list option.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})]}),_jsx(Step,{title:`Name and activate the attribute`,children:_jsxs(_components.p,{children:[`Choose the Team dimension, name the attribute `,_jsx(_components.code,{children:`IT Security Access Request Handlers`}),`, accept the derived handle of `,_jsx(_components.code,{children:`it-sec-access-request-handlers`}),`, decline the expiration override, and activate it.`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`16-describe-the-new-attribute`,children:`16. Describe the new attribute`}),`\n`,_jsx(Steps,{children:_jsxs(Step,{title:`Review the attribute layout`,children:[_jsx(_components.p,{children:`The describe output has the same layout as the first attribute. It sits on the Team dimension, it has a Policy Ruleset of its own, and every user count is zero until you add a rule.`}),_jsx(CodeBlock,{numberOfLines:`12`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`12`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`┌ Child Relationships ─────────────────────────────────────┐`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` Attribute Conditions 0`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` Attribute Predecessors 0`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` Policy Rules 0`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` Manifest Users 0`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` Qualified Users 0`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` Staged Users 0`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` Audit Logs Parent 0`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` Audit Logs Record 2`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` Audit Logs Related 0`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`└──────────────────────────────────────────────────────────┘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})]})}),`\n`,_jsx(Heading,{level:`2`,id:`17-use-a-team-attribute-as-a-condition`,children:`17. Use a team attribute as a condition`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Add the team attribute condition`,children:[_jsxs(_components.p,{children:[`The first rule used the job title attribute as a condition. A team attribute can be used the same way, so this rule nests one team inside another. Select `,_jsx(_components.strong,{children:`Create Policy Rule`}),`, add a justification such as the identity engineering team helping with access requests, and choose `,_jsx(_components.strong,{children:`Users attached to an Attribute`}),`.`]}),_jsxs(_components.p,{children:[`Select `,_jsx(_components.strong,{children:`No - Search for Attribute`}),`, choose the Team dimension, and choose the IT Identity Engineering Team attribute.`]}),_jsx(CodeBlock,{numberOfLines:`7`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`┌ Select a Directory Attribute ─────────────────────────────────────────────────────────────┐`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ Keyword from id, integration.vendor, dimension.handle, name, handle, count.manifest_users │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`├───────────────────────────────────────────────────────────────────────────────────────────┤`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ › dratr_… - n/a - team - It Identity Engineering Team - it-identity-eng-team │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`└───────────────────────────────────────────────────────────────────────────────────────────┘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` These options have not been filtered based on the conditional users.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})]}),_jsxs(Step,{title:`Review the staged list`,children:[_jsx(_components.p,{children:`Every user on that team is added to the staged list for this rule, including the manager who qualified through the named user rule. The users were inherited from the upstream attribute, and when that attribute changes the change carries through to everything downstream that uses it.`}),_jsx(CodeBlock,{numberOfLines:`9`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`9`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Rule Conditions`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`┌──────┬───────────┬─────────────────────────────────────────────────────────┐`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ id │ type │ description │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`├──────┼───────────┼─────────────────────────────────────────────────────────┤`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ cmn0 │ attribute │ Users attached to the It Identity Engineering Team team │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`└──────┴───────────┴─────────────────────────────────────────────────────────┘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`1 Records`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})]}),_jsx(Step,{title:`Activate the rule`,children:_jsxs(_components.p,{children:[`Answer `,_jsx(_components.strong,{children:`No`}),` to adding another condition and activate the rule.`]})})]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`The same approach applies to any other resource that you attach to an attribute, such as an application in your Identity Provider, a Google Group, a Slack group, or a GitLab group. You define the team once and reuse it.`})}),`\n`,_jsx(Heading,{level:`2`,id:`18-reach-the-command-menu`,children:`18. Reach the command menu`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Open the menu after the error`,children:[_jsxs(_components.p,{children:[`Selecting `,_jsx(_components.strong,{children:`Manage a different resource`}),` from the `,_jsx(_components.strong,{children:`Next Step`}),` menu returned an error in the recording. The command that option calls has been renamed, so run `,_jsx(_components.code,{children:`prv menu`}),` in your terminal to reach the same place.`]}),_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` ERROR Command \"wizard\" is not defined.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`prv`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` menu`})]}),`\n`]})})})]}),_jsx(Step,{title:`Navigate the menu`,children:_jsxs(_components.p,{children:[`The menu walks you down a namespace, a resource, and an action. Choose `,_jsx(_components.strong,{children:`Provisionr Directory`}),`, then `,_jsx(_components.strong,{children:`Directory Attribute`}),`, then `,_jsx(_components.strong,{children:`Create a Custom Directory Attribute`}),`.`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`19-create-the-helpdesk-team-attribute`,children:`19. Create the helpdesk team attribute`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`Create and activate the attribute`,children:_jsxs(_components.p,{children:[`Create the third attribute on the Team dimension, name it `,_jsx(_components.code,{children:`IT Security Helpdesk Team`}),`, accept the handle of `,_jsx(_components.code,{children:`it-sec-helpdesk-team`}),`, decline the expiration override, and activate it.`]})}),_jsxs(Step,{title:`Check the titles in the second terminal`,children:[_jsxs(_components.p,{children:[`The users for this team are not known yet, so use the second terminal to look at the titles first. Reset the filters from earlier, filter by an exact value in the `,_jsx(_components.strong,{children:`org.title`}),` field, and type part of the title into the search row.`]}),_jsx(CodeBlock,{numberOfLines:`7`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`┌ Filter by Directory User ┐`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ it sec │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`├──────────────────────────┤`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ IT Security Engineer │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`└──────────────────────────┘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` Enter a keyword and/or use ↑ and ↓ arrow keys. Press RETURN to select a list option.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`prv`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` directory-user:list`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --where=org.title=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'IT Security Engineer'`})]}),`\n`]})})})]}),_jsx(Step,{title:`Review the titles`,children:_jsx(_components.p,{children:`Some organizations use generic job titles and some use specific ones, so it is worth checking whether a separate help desk title exists. In this directory there is no help desk title, and every one of these users carries the IT Security Engineer title.`})})]}),`\n`,_jsx(Heading,{level:`2`,id:`20-select-an-attribute-from-an-existing-user`,children:`20. Select an attribute from an existing user`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Create the rule from an existing user`,children:[_jsxs(_components.p,{children:[`Create a policy rule on the helpdesk attribute with a justification such as helpdesk engineers having access to their own team, then select `,_jsx(_components.strong,{children:`Users attached to an Attribute`}),` again.`]}),_jsxs(_components.p,{children:[`This time answer `,_jsx(_components.strong,{children:`Yes - Use Existing User`}),`. Choose a user who already holds the IT Security Engineer title, and the attribute picker lists only the attributes that are on that user.`]}),_jsx(CodeBlock,{numberOfLines:`6`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`6`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`┌ Use a User to select an Attribute? ┐`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ › ● Yes - Use Existing User │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ No - Search for Attribute │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`└────────────────────────────────────┘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` You can choose an attribute from an existing user instead of searching all attributes`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsx(CodeBlock,{numberOfLines:`7`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`┌ Select a Directory Attribute ─────────────────────────────────────────────────────────────┐`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ Keyword from id, integration.vendor, dimension.handle, name, handle, count.manifest_users │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`├───────────────────────────────────────────────────────────────────────────────────────────┤`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ › dratr_01kytjhqrqqx8zmczjtpmampy9 - n/a - title - IT Security Engineer - it-sec-eng │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`└───────────────────────────────────────────────────────────────────────────────────────────┘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` These options are filtered based on the selected user.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})]}),_jsx(Step,{title:`Add the manager condition`,children:_jsxs(_components.p,{children:[`Choose the job title attribute and save the changes. This returns the same 20 users as before, so add a second condition for `,_jsx(_components.strong,{children:`Users reporting to a Manager`}),` and select a different manager from that list. Save the changes, answer `,_jsx(_components.strong,{children:`No`}),` to adding another condition, and activate the rule.`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`21-add-a-named-user-rule-for-the-helpdesk-team`,children:`21. Add a named user rule for the helpdesk team`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Create another rule for the manager`,children:[_jsxs(_components.p,{children:[`Select `,_jsx(_components.strong,{children:`Create another Policy Rule`}),` to add the manager. The role picker shows the member role for the directory attribute, and from there the flow is the one you used for the first team.`]}),_jsx(CodeBlock,{numberOfLines:`4`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`4`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`┌ Select a Role for this Rule ────────────────────┐`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ › porol_… - directory_attribute - member - true │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`└─────────────────────────────────────────────────┘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})]}),_jsx(Step,{title:`Add the named user condition`,children:_jsxs(_components.p,{children:[`Add a justification, select `,_jsx(_components.strong,{children:`Named User`}),`, choose the manager, and save the changes.`]})}),_jsxs(Step,{title:`Review the manifest`,children:[_jsx(_components.p,{children:`Move back up to the attribute and the manifest count covers both rules. The users who report to that manager and hold the IT Security Engineer title are on the manifest through the first rule, and the manager is on it through the second.`}),_jsx(CodeBlock,{numberOfLines:`9`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`9`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`┌ Child Relationships ─────────┐`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` Attribute Conditions 0`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` Attribute Predecessors 0`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` Policy Rules 2`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` Manifest Users 6`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` Qualified Users 6`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` Staged Users 0`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`└──────────────────────────────┘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`22-find-an-attribute-in-the-attribute-list`,children:`22. Find an attribute in the attribute list`}),`\n`,_jsx(Steps,{children:_jsxs(Step,{title:`Search for the attribute`,children:[_jsxs(_components.p,{children:[`The access request handlers team was created before the helpdesk team existed, so the helpdesk team can now be added to it. List the attributes across every dimension, select `,_jsx(_components.strong,{children:`Describe/Manage Attribute`}),`, and search for the attribute by keyword.`]}),_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`prv`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` directory-attribute:list`})]}),`\n`]})})}),_jsx(CodeBlock,{numberOfLines:`7`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`┌ Search for Attribute ──────────────────────────────────────────────────────────────────────────────┐`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ access │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`├────────────────────────────────────────────────────────────────────────────────────────────────────┤`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ › dratr_… - n/a - team - It Security Access Request Handlers - it-sec-access-request-handlers - 10 │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`└────────────────────────────────────────────────────────────────────────────────────────────────────┘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` Enter a keyword and/or use ↑ and ↓ arrow keys. Press RETURN to select a list option.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})]})}),`\n`,_jsx(Heading,{level:`2`,id:`23-add-a-rule-to-an-existing-attribute`,children:`23. Add a rule to an existing attribute`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Create the rule on the access request attribute`,children:[_jsxs(_components.p,{children:[`From the attribute, select `,_jsx(_components.strong,{children:`Create Policy Rule`}),`, add a justification such as the help desk handling access requests, and choose `,_jsx(_components.strong,{children:`Users attached to an Attribute`}),` followed by `,_jsx(_components.strong,{children:`No - Search for Attribute`}),`.`]}),_jsxs(_components.p,{children:[`Select the Team dimension first, which now reports three attributes, and then select the IT Security Helpdesk Team attribute with its six manifest users. Read the results in the picker before you press `,_jsx(`kbd`,{children:`ENTER`}),`/`,_jsx(`kbd`,{children:`RETURN`}),`, since the dimension is selected before the attribute.`]}),_jsx(CodeBlock,{numberOfLines:`10`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`10`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Review Your Changes`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`┌────────────────────────┬──────────────────────────────────┐`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ Attribute │ Value │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`├────────────────────────┼──────────────────────────────────┤`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ policy_rule_id │ porul_01kytqzj8fktrhk0ng75w5q59k │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ type │ attribute │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ directory_attribute_id │ dratr_… │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`└────────────────────────┴──────────────────────────────────┘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})]}),_jsx(Step,{title:`Save the changes`,children:_jsx(_components.p,{children:`Save the changes. The helpdesk users are now mapped to both teams, and the helpdesk attribute is the source of truth for who they are.`})})]}),`\n`,_jsx(Heading,{level:`2`,id:`24-review-the-rule-activation-prompt`,children:`24. Review the rule activation prompt`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Review the activation prompt`,children:[_jsxs(_components.p,{children:[`Answer `,_jsx(_components.strong,{children:`No`}),` to adding another condition and the CLI presents the activation prompt for the new rule.`]}),_jsx(CodeBlock,{numberOfLines:`8`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`8`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`┌ Activating the Rule ─────────────────────────────────────┐`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Activation will immediately add corresponding`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`policy user(s) manifest and grant access.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`If you do not want to grant access, keep the rule`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`staged and activate later using policy-rule:activate.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`└──────────────────────────────────────────────────────────┘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsx(CodeBlock,{numberOfLines:`5`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`┌ Do you want to activate the rule? ┐`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ › ● Yes - Activate │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ No - Staged for later │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`└───────────────────────────────────┘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})]}),_jsxs(Step,{title:`Activate later if needed`,children:[_jsx(_components.p,{children:`In the recording this prompt was cancelled and the rule was left staged. You can activate a staged rule at any time by running the activate command with the rule ID.`}),_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`prv`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` policy-rule:activate`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --id=POLICY_RULE_ID`})]}),`\n`]})})})]})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create IT Team Attributes","description":"Build a custom Team dimension, add team attributes, and write attribute, manager, and named-user policy rules that assign the right people to IT security teams automatically as your directory changes in Provisionr.","icon":"rebel","href":"/runbooks/orientation/it"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"What you’ll learn","slug":"what-you’ll-learn","depth":2,"children":[]},{"title":"Prerequisites","slug":"prerequisites","depth":2,"children":[]},{"title":"1. Review dimensions with attributes enabled","slug":"1-review-dimensions-with-attributes-enabled","depth":2,"children":[]},{"title":"2. Create the Team dimension","slug":"2-create-the-team-dimension","depth":2,"children":[]},{"title":"3. Add an attribute to the dimension","slug":"3-add-an-attribute-to-the-dimension","depth":2,"children":[]},{"title":"4. Review the attribute’s policy ruleset","slug":"4-review-the-attribute’s-policy-ruleset","depth":2,"children":[]},{"title":"5. List the empty manifest","slug":"5-list-the-empty-manifest","depth":2,"children":[]},{"title":"6. Create the first policy rule","slug":"6-create-the-first-policy-rule","depth":2,"children":[]},{"title":"7. Add a condition on an existing attribute","slug":"7-add-a-condition-on-an-existing-attribute","depth":2,"children":[]},{"title":"8. Check the filter in a second terminal","slug":"8-check-the-filter-in-a-second-terminal","depth":2,"children":[]},{"title":"9. Add a condition for users reporting to a manager","slug":"9-add-a-condition-for-users-reporting-to-a-manager","depth":2,"children":[]},{"title":"10. Activate the rule","slug":"10-activate-the-rule","depth":2,"children":[]},{"title":"11. Review the activated rule","slug":"11-review-the-activated-rule","depth":2,"children":[]},{"title":"12. Add a named user rule","slug":"12-add-a-named-user-rule","depth":2,"children":[]},{"title":"13. Review the rules and the manifest","slug":"13-review-the-rules-and-the-manifest","depth":2,"children":[]},{"title":"14. Find the Team dimension in the full list","slug":"14-find-the-team-dimension-in-the-full-list","depth":2,"children":[]},{"title":"15. Create a second team attribute","slug":"15-create-a-second-team-attribute","depth":2,"children":[]},{"title":"16. Describe the new attribute","slug":"16-describe-the-new-attribute","depth":2,"children":[]},{"title":"17. Use a team attribute as a condition","slug":"17-use-a-team-attribute-as-a-condition","depth":2,"children":[]},{"title":"18. Reach the command menu","slug":"18-reach-the-command-menu","depth":2,"children":[]},{"title":"19. Create the helpdesk team attribute","slug":"19-create-the-helpdesk-team-attribute","depth":2,"children":[]},{"title":"20. Select an attribute from an existing user","slug":"20-select-an-attribute-from-an-existing-user","depth":2,"children":[]},{"title":"21. Add a named user rule for the helpdesk team","slug":"21-add-a-named-user-rule-for-the-helpdesk-team","depth":2,"children":[]},{"title":"22. Find an attribute in the attribute list","slug":"22-find-an-attribute-in-the-attribute-list","depth":2,"children":[]},{"title":"23. Add a rule to an existing attribute","slug":"23-add-a-rule-to-an-existing-attribute","depth":2,"children":[]},{"title":"24. Review the rule activation prompt","slug":"24-review-the-rule-activation-prompt","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/provisionr/68f8bc905a4b045e/scripts/lint-frontmatter.js"],"subdomain":"provisionr","siteName":"Provisionr","title":"Create IT Team Attributes - Provisionr","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-10T02:44:51.828Z","originalFileLocation":"runbooks/orientation/it.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Build a custom Team dimension, add team attributes, and write attribute, manager, and named-user policy rules that assign the right people to IT security teams automatically as your directory changes in Provisionr.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Provisionr\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/provisionr/BrF5IHgBTE7iRl5b/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/provisionr/BrF5IHgBTE7iRl5b/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/provisionr/BrF5IHgBTE7iRl5b/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/provisionr/BrF5IHgBTE7iRl5b/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/provisionr/BrF5IHgBTE7iRl5b/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/provisionr/BrF5IHgBTE7iRl5b/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/provisionr/BrF5IHgBTE7iRl5b/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/provisionr/BrF5IHgBTE7iRl5b/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/provisionr/BrF5IHgBTE7iRl5b/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create IT Team Attributes - Provisionr\">\u003cmeta data-mint-head property=\"og:description\" content=\"Build a custom Team dimension, add team attributes, and write attribute, manager, and named-user policy rules that assign the right people to IT security teams automatically as your directory changes in Provisionr.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Provisionr\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.provisionr.io/runbooks/orientation/it\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://provisionr.mintlify.site/_mintlify/api/og/v2?division=Orientation\u0026amp;title=Create+IT+Team+Attributes\u0026amp;description=Build+a+custom+Team+dimension%2C+add+team+attributes%2C+and+write+attribute%2C+manager%2C+and+named-user+policy+rules+that+assign+the+right+people+to+IT+security+teams+\u0026amp;theme=f6bc4ae197310e5c36fffed9\u0026amp;signature=04901b3a093c2a7b3a5fd634297400f65e607c81e3a643f20c3873da68a5a6f9\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create IT Team Attributes - Provisionr\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Build a custom Team dimension, add team attributes, and write attribute, manager, and named-user policy rules that assign the right people to IT security teams automatically as your directory changes in Provisionr.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://provisionr.mintlify.site/_mintlify/api/og/v2?division=Orientation\u0026amp;title=Create+IT+Team+Attributes\u0026amp;description=Build+a+custom+Team+dimension%2C+add+team+attributes%2C+and+write+attribute%2C+manager%2C+and+named-user+policy+rules+that+assign+the+right+people+to+IT+security+teams+\u0026amp;theme=f6bc4ae197310e5c36fffed9\u0026amp;signature=04901b3a093c2a7b3a5fd634297400f65e607c81e3a643f20c3873da68a5a6f9\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/provisionr/BrF5IHgBTE7iRl5b/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Provisionr\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#d946ef\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.provisionr.io/runbooks/orientation/it\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/runbooks/orientation/it.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.provisionr.io/#organization\",\"name\":\"Provisionr\",\"url\":\"https://docs.provisionr.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/provisionr/5ukSD9JI1H_kpmU4/logo/light.svg?fit=max\u0026auto=format\u0026n=5ukSD9JI1H_kpmU4\u0026q=85\u0026s=6dc390c4a465580ff27f8fe8d49a11fc\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.provisionr.io#website\",\"name\":\"Provisionr\",\"url\":\"https://docs.provisionr.io\",\"publisher\":{\"@id\":\"https://docs.provisionr.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.provisionr.io/runbooks/orientation/it#webpage\",\"url\":\"https://docs.provisionr.io/runbooks/orientation/it\",\"name\":\"Create IT Team Attributes\",\"description\":\"Build a custom Team dimension, add team attributes, and write attribute, manager, and named-user policy rules that assign the right people to IT security teams automatically as your directory changes in Provisionr.\",\"dateModified\":\"2026-11-10T02:44:51.828Z\",\"isPartOf\":{\"@id\":\"https://docs.provisionr.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.provisionr.io/runbooks/orientation/it#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.provisionr.io/runbooks/orientation/it#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Orientation\",\"item\":\"https://docs.provisionr.io/runbooks/orientation/attributes\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create IT Team Attributes\",\"item\":\"https://docs.provisionr.io/runbooks/orientation/it\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.provisionr.io/runbooks/orientation/it#article\",\"headline\":\"Create IT Team Attributes\",\"name\":\"Create IT Team Attributes\",\"description\":\"Build a custom Team dimension, add team attributes, and write attribute, manager, and named-user policy rules that assign the right people to IT security teams automatically as your directory changes in Provisionr.\",\"url\":\"https://docs.provisionr.io/runbooks/orientation/it\",\"mainEntityOfPage\":{\"@id\":\"https://docs.provisionr.io/runbooks/orientation/it#webpage\"},\"dateModified\":\"2026-11-10T02:44:51.828Z\",\"publisher\":{\"@id\":\"https://docs.provisionr.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.provisionr.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Provisionr\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Provisionr\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/runbooks/orientation/it.md","siteName":"Provisionr","nav":{"global":{"anchors":[{"anchor":"Documentation","icon":"file-lines","href":"https://docs.provisionr.io"},{"anchor":"Workspace HQ","icon":"server","href":"https://hq.provisionr.io"},{"anchor":"Slack Community","icon":"slack","href":"https://community.provisionr.io"},{"anchor":"Support Ticket","icon":"comments","href":"https://docs.provisionr.io/support/help"}]},"tabs":[{"tab":"Why Provisionr","pages":[{"title":"Why Provisionr","href":"/why/intro/mission"}]},{"tab":"Concepts","pages":[{"title":"Concepts","href":"/concepts/control/users"}]},{"tab":"Runbooks","groups":[{"group":"Orientation","icon":"graduation-cap","expanded":true,"pages":[{"title":"Explore Users and Attributes","description":"Browse, filter, and export directory users synced from Okta or Google Workspace, and trace every identity's attributes, policy grants, and audit trail in Provisionr.","icon":"folder-tree","href":"/runbooks/orientation/attributes"},{"title":"Create IT Team Attributes","icon":"rebel","href":"/runbooks/orientation/it"},{"title":"Create Sales Region Attributes","description":"Extract your sales division from the directory, map its reporting lines in a spreadsheet, and build regional team, geography, and manager rulesets from attributes, conditions, and audit logs in Provisionr.","icon":"map-location-dot","href":"/runbooks/orientation/sales"},{"title":"Create Manager Team Attributes","icon":"chart-diagram","href":"/runbooks/orientation/manager"},{"title":"Manage a Google Group","icon":"google","href":"/runbooks/orientation/google"},{"title":"Manage an Okta App Group","icon":"https://mintlify.s3.us-west-1.amazonaws.com/provisionr/icons/okta.svg","href":"/runbooks/orientation/okta"}]},{"group":"Operations","icon":"rectangle-list","expanded":true,"pages":[{"title":"Create a Custom Dimension","icon":"shapes","href":"/runbooks/ops/dimension"},{"title":"Change Management","icon":"calendar-check","href":"/runbooks/ops/changes"}]},{"group":"Coming Soon","icon":"pen-to-square","expanded":false,"pages":[{"title":"Getting Started (First 90 Days)","icon":"circle-play","href":"/runbooks/ops/intro"},{"title":"Scheduled Sync","icon":"arrows-rotate","href":"/runbooks/ops/sync"},{"title":"Managing Manifests","icon":"clipboard-list","href":"/runbooks/ops/manifests"},{"title":"Onboarding (Joiners)","icon":"plane-arrival","href":"/runbooks/ops/joiners"},{"title":"Job Changes (Movers)","icon":"person-walking-dashed-line-arrow-right","href":"/runbooks/ops/movers"},{"title":"Offboarding (Leavers)","icon":"plane-departure","href":"/runbooks/ops/leavers"},{"title":"Org and Team Realignments","icon":"folder-tree","href":"/runbooks/ops/realignments"},{"title":"Expiring Access (Deprecation)","icon":"user-clock","href":"/runbooks/ops/deprecation"},{"title":"User Self Service","icon":"file-contract","href":"/runbooks/ops/self-service"},{"title":"Changes and Approvals","icon":"file-signature","href":"/runbooks/ops/approvals"},{"title":"Just-in-Time (JIT) Access","icon":"person-military-pointing","href":"/runbooks/ops/jit"},{"title":"Acknowledging Events","icon":"list-check","href":"/runbooks/ops/events"},{"title":"Managing Vendor Resources","icon":"diagram-successor","href":"/runbooks/ops/vendors"}]}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/integrations/overview"}]},{"tab":"API Endpoints","pages":[{"title":"API Endpoints","href":"/api/workspace/v1/overview"}]},{"tab":"CLI Commands","pages":[{"title":"CLI Commands","href":"/cli/workspace/v1/intro/install"}]},{"tab":"Release Notes and Roadmap","pages":[{"title":"Release Notes and Roadmap","href":"/roadmap/features"}]},{"tab":"Support","pages":[{"title":"Support","href":"/support/help"}]},{"tab":"Billing","pages":[{"title":"Billing","href":"/plans/evaluator"}]}]},"basePath":"","title":"Create IT Team Attributes - Provisionr","buildId":"dpl_GRSyrvXT6FFTpZZTGz5iZPp3D2zE","deploymentId":"dpl_GRSyrvXT6FFTpZZTGz5iZPp3D2zE","dynamics":[],"chunks":[]}