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.
Now that your Identity Provider (IdP) mappings are configured, you can explore the full directory of users that were imported and see how Provisionr ties each person to attributes, policy users, and rules through IDs rather than fragile strings.This walkthrough follows one example user — Grant Keyes, an IT Security Engineer — from a simple filtered list all the way through to creating and activating a new policy rule.
What you’ll learn
Filter and export directory users by exact string values and by relationships.
Trace how a user connects to attributes, policy users, and rules through stable IDs instead of fragile strings.
Rename an attribute without breaking any of the policies, groups, or resources tied to it.
Read audit logs to see who changed what, when, and the before-and-after values.
Create, add conditions to, and activate a new policy rule ahead of an upstream change.
Prerequisites
A workspace with a completed Okta or Google Workspace integration sync.
The IDs shown below (drusr_…, dratr_…, poset_…, 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. Filter list of users by string
1
List the directory users
Start by listing every directory user that has been imported.
prv directory-user:list
Below the table you can see the count of active records, expiring records, and total records in your directory.
2
Open the filter menu
In the Next Step menu, press the ↓ arrow or TAB to move the radio option to Filter List of Results and press ENTER/RETURN.
┌ Next Step ──────────────────────────────────────────┐│ ○ I'm all set! ││ ○ Describe/Manage Directory User ││ ○ Filter by Attribute, Group, or Resource ││ › ● Filter List of Results ││ ○ Edit Column Display Settings ││ ○ Run Same Command (to get refreshed results) ││ ○ View Soft Deleted (Expired/Deactivated) Records ││ ○ Export Results to File or Spreadsheet ││ ○ View Raw JSON Output ││ ○ Manage a Different Resource │└─────────────────────────────────────────────────────┘
3
Choose the filter method
You can search for exact or partial values, run a global search across all fields, or filter by boolean or date values. Leave Filter by an exact value in specific field selected and press ENTER/RETURN.
┌ Filter Method ───────────────────────────────────────────────┐│ › ● Filter by an exact value in specific field ││ ○ Filter by a partial value in specific field ││ ○ Global search (all fields) for a partial string match ││ ○ Filter by boolean value ││ ○ Filter by date (timestamp before or after specific date) ││ ○ Reset filters to show all records │└──────────────────────────────────────────────────────────────┘
4
Select the field to filter on
You can choose any field that is available in the API results, including ones that aren’t shown in the table. The org. fields are a flattened list of the profile attributes that a user has been mapped to.Press the ↓ arrow or TAB until the radio option highlights org.title and press ENTER/RETURN.
┌ Filter by Field Exact Match ────────────────┐│ ○ id Ex. drusr_01kytjerc9xgyep0wp3qgx45b7 ││ ○ full_name Ex. Aarav Agarwal ││ ○ email Ex. [email protected] ││ ○ org.dept Ex. Product Development ││ › ● org.title Ex. Software Engineer ││ ○ manager.full_name Ex. Rahul Reddy ││ ○ first_name Ex. Aarav ││ ○ last_name Ex. Agarwal ││ ○ username Ex. aagarwal ││ ○ employee_id_alt ││ ○ deleted ││ ○ state Ex. active │└─────────────────────────────────────────────┘
5
Choose the value
Every value that exists for that field is listed, so you do not have to remember how the string is spelled. This list is scrollable and searchable.Press the ↓ arrow or TAB several times to scroll down through the results. You will notice the scroll bar on the right-hand side move down.
┌ Filter by Directory User ──────┐│ │├────────────────────────────────┤│ › Account Executive ││ Accountant ││ Customer Success Manager ││ Director, Engineering ││ Director, Operations ││ Director, Sales ││ Engineering Manager ││ Finance Manager ││ IT Manager ││ IT Security Engineer │└────────────────────────────────┘ Enter a keyword and/or use ↑ and ↓ arrow keys. Press RETURN to select a list option.
The empty row below the box title is a search input, so you can type part of a word, a full word, or the entire string to narrow the list. Type the word engineer, then use the ↑ or ↓ arrows to move to the value you want. Select IT Security Engineer and press ENTER/RETURN.
You will see a table of results for users with the filtered job title. Scroll to the top of the table and you will see that any applied filter(s) are shown below the command header, so you can copy and paste the CLI command with the arguments to get the same results without using the filter menu.
These users all share a job title, but they are not all on the same team. Let’s filter this down to just the people on the same team as Grant Keyes.In the table, locate the manager.full_name column and take note of Grant Keyes’s manager. Select the Filter List of Results option again, leave Filter by an exact value in specific field selected, choose the manager.full_name field, and select the manager from the value list.
2
Review the combined command
After the second filter is applied, both filters are shown in the command above the table. Keep in mind that the manager filter is written as included.user_manager.full_name, which is the API path for the related manager record rather than the manager.full_name label shown in the field menu that was shortened for terminal column-width brevity.
You now have 9 records, which are the users with the IT Security Engineer title who report to Wren Odell.
This is an example of string matching that is historically used for group rules. String rules commonly break, and users lose access, when the strings are changed upstream in your HRIS or IdP.If you can define the string matching in a single source of truth and use IDs when working with group rules and policy conditions, it will be easier to handle changes from upstream data sources.
3. Export records
1
Open the export option
You can export this filtered set of users to a CSV, JSON, or YAML file that you can import into Google Sheets, Microsoft Excel, an audit evidence platform, or another tool of your choice.In the Next Step menu, select the Export Results to File or Spreadsheet option.
┌ Next Step ───────────────────────────────────────────┐│ ○ I'm all set! ││ ○ Describe/Manage Directory User ││ ○ Filter by Attribute, Group, or Resource ││ ○ Filter List of Results ││ ○ Edit Column Display Settings ││ ○ Reset List Filters ││ ○ Run Same Command (to get refreshed results) ││ ○ View Soft Deleted (Expired/Deactivated) Records ││ › ● Export Results to File or Spreadsheet ││ ○ View Raw JSON Output ││ ○ Manage a Different Resource │└──────────────────────────────────────────────────────┘
2
Choose columns and format
You can choose which columns/keys to include in the spreadsheet. Use the arrow keys to scroll down to see all of the options. Press SPACE to check or uncheck a column.Press ENTER/RETURN to save your selection, then use the arrow keys to select CSV. Your CSV file will be saved to the ~/Downloads/provisionr folder, which is created if it does not exist already. Each file export is timestamped.
3
Export other resources (optional)
Almost every resource list command has an export command as well, to let you export all records easily. If you want to apply filters, you can use the list command to filter the records or use CLI arguments for the export command.
prv directory-user:export --help
prv list | grep export
The export command is restricted to users with the export permission for the respective resource, to avoid unintended data exfiltration.
4. Filter by an attribute
1
Open the attribute filter
Now that you’ve seen how to filter based on strings, let’s filter based on relationships.Based on what you’ve learned so far, get a list of users, use the Next Step menu to select Filter by Attribute, Group, or Resource, and select the Directory Attribute option.
prv directory-user:list
┌ Next Step ──────────────────────────────────────────┐│ ○ I'm all set! ││ ○ Describe/Manage Directory User ││ › ● Filter by Attribute, Group, or Resource ││ ○ Filter List of Results ││ ○ Edit Column Display Settings ││ ○ Run Same Command (to get refreshed results) ││ ○ View Soft Deleted (Expired/Deactivated) Records ││ ○ Export Results to File or Spreadsheet ││ ○ View Raw JSON Output ││ ○ Manage a Different Resource │└─────────────────────────────────────────────────────┘
┌ Select a Ruleset Type ───┐│ │├──────────────────────────┤│ › Directory Attribute ││ Google Workspace Group ││ Okta Group │└──────────────────────────┘
2
Select the Title dimension
A dimension was created for each of the profile keys imported from the Identity Provider. Select the Title dimension.
The attribute list shows every unique value that exists for that dimension (profile key) across all users. Each row shows the attribute ID, the integration vendor, the dimension handle, the attribute name, the attribute handle, and the number of users mapped to it. This list is searchable as well.Select the attribute for the same IT Security Engineer job title you filtered on above.
┌ Select an Attribute ────────────────────────────────────────────────────────────────────────────────────┐│ Keyword from id, integration.vendor, dimension.handle, name, handle, count.manifest_users │├─────────────────────────────────────────────────────────────────────────────────────────────────────────┤│ dratr_01kytjhpws0x975jdsaf6hcp89 - n/a - title - Accountant - accountant - 40 ││ dratr_01kytjhps6p0x4h7rnchpzf7kg - n/a - title - Account Executive - acct-exec - 162 ││ dratr_01kytjhq09zakpr5bzhbrh814e - n/a - title - Customer Success Manager - customer-success-mgr - 90 ││ dratr_01kytjhq3t6x6xss3wb8pn1600 - n/a - title - Director, Engineering - dir-eng - 12 ││ dratr_01kytjhq7rxnbegrsc11hzgwds - n/a - title - Director, Operations - dir-ops - 8 ││ dratr_01kytjhqb0ybxq9p38jbbg4hak - n/a - title - Director, Sales - dir-sales - 10 ││ dratr_01kytjhqe1px7mg9z1gv3ffcap - n/a - title - Engineering Manager - eng-mgr - 44 ││ dratr_01kytjhqhks87r6waan672h4x8 - n/a - title - Finance Manager - fin-mgr - 13 ││ dratr_01kytjhqn9ahe3qh291hnwqjpa - n/a - title - IT Manager - it-mgr - 8 ││ › dratr_01kytjhqrqqx8zmczjtpmampy9 - n/a - title - IT Security Engineer - it-sec-eng - 20 │└─────────────────────────────────────────────────────────────────────────────────────────────────────────┘ Press Ctrl+U to undo and choose a different dimension
Every user, dimension, attribute, policy ruleset, rule, condition, and mapping has a database row in Provisionr with its own lifecycle — a created-at, activated-at, expires-at, and deactivated-at timestamp. That lets you see when a user joined an attribute and when they left it, instead of only knowing that a string is different today than it was before.You are seeing a list of Directory Attributes that have a foreign key matching the ID of the Title dimension.
5. Understand policy users
1
List the ruleset's policy users
Selecting the attribute shows a list of policy users for the ruleset that belongs to that attribute.
A policy user record is the mapping between one directory user and one resource. The resource.parent column is the dimension, in this case title, and the resource.handle column is the attribute itself. The rule.id column tells you which rule caused the user to be attached to that resource.The same 20 people you saw with the exact-value filter are here, and each one now has a record with its own state and its own timestamps.
6. Export the policy users
1
Open the export option
In the Next Step menu, select the Export Results to File or Spreadsheet option to take this data into a spreadsheet, an audit platform, or your own data set as evidence of where each mapping came from.
You choose which keys to include. Press SPACE to check or uncheck an option, use the ↑ and ↓ arrows to scroll, and press ENTER/RETURN to submit. The count of selected keys is shown in the box as you go.
┌ Select attributes to export ──────────────────────┐│ ◼ directory_user.full_name Ex. Alberto Mendoza ││ › ● directory_user.email Ex. [email protected] ││ ○ directory_user.username Ex. amendoza ││ ○ directory_user.badge_id ││ ○ directory_user.employee_id Ex. 02f67a7c ││ ○ directory_user.employee_alt_id ││ ○ directory_user.org.cost-center Ex. G&A ││ ○ directory_user.org.country-code Ex. ES ││ ○ directory_user.org.dept Ex. IT ││ ○ directory_user.org.division Ex. Operations │└─────────────────────────────────────── 9 selected ┘ Press SPACE to select, up and down arrow to scroll, RETURN to submit
Notice the scroll bar on the right-hand side of the box. The directory user fields are at the top, followed by the policy rule fields.Enable the checkboxes for the following columns and export the CSV file.
timestamp.created_at
timestamp.expires_at
policy_rule.role_handle
policy_rule.description
policy_resource.name
policy_resource.profile_value
You now have the policy data with the date the user was associated with the attribute, the justification message for the rule with the conditions they qualified for, and the current Provisionr attribute name and Identity Provider profile key value for correlation reference.
7. Copy a command from the output
1
Reuse a printed command
Every command is printed above its output, including the commands the wizard ran for you. Scroll up in your terminal, copy the policy user list command, and paste it to come back to the same list without walking through the menus again.
Select the Describe/Manage Policy User option and select Grant Keyes in the list.The first panel is the policy user record itself, with the state and the timestamps for when it was created, updated, activated, and when it expires or was deleted.
Policy User id pousr_01abc123... state active timestamp.created_at 2026-07-30 22:35 UTC (34m) timestamp.updated_at 2026-07-30 22:35 UTC (34m) timestamp.activated_at 2026-07-30 22:35 UTC (34m) timestamp.expires_at timestamp.deleted_at
2
Review the related records
Scroll down and you will see the panels for each record in the relationship.
The directory user panel is the profile data you have already seen.
The policy rule panel shows the role the user was granted, whether the rule was imported, the justification description, and how many days after which the grant expires.
The policy ruleset panel shows the type of ruleset and the resource it is attached to. The policy resource panel is the attribute itself, with its parent dimension, its name, its handle, and the profile value that came from your Identity Provider.
The Next Step menu lets you navigate to any of those related records, or read the audit logs for the policy user.
┌ Next Step ───────────────────────────────┐│ › ● I'm all set! ││ ○ View Directory User ││ ○ View Policy Resource ││ ○ View Policy Rule Conditions ││ ○ View Policy Ruleset ││ ○ View Policy Rule ││ ○ Refresh this Data from the API ││ ○ View Raw JSON Output ││ ○ View Audit Logs for this Policy User ││ ○ List of Policy Users ││ ○ Manage a different resource │└──────────────────────────────────────────┘
9. Explore user attributes
1
List the user's attributes
You can explore the Policy User records from the directory user instead of from the attribute. Navigate to the Directory User and select the View Attributes, Groups, or Resources option from the Next Step menu.
This lists one policy user record for every attribute the user is attached to, across all of the dimensions that were imported, not only the job title. The resource.parent column tells you which dimension each row belongs to.
10. Update the attribute handle
1
Rename the attribute handle
Describe the Policy Resource to navigate to the IT Security Engineer title attribute and select Update this Attribute. Select the handle key and enter sec-eng, then save the change.
prv directory-attribute:update --id=ATTRIBUTE_ID
11. Explore audit logs
1
Open the attribute's audit logs
In the Next Step menu, select the View Audit Logs for this Attribute option, then select the View Logs for this Record log type.
prv audit-log:list --record_id=ATTRIBUTE_ID
2
What to look for
The list shows the ID, the timestamp, the actor who made the change, the level, the event type, the parent record, and the record itself. You will see a directory.attribute.import.success event from when the attribute was created during the import, with the dimension as its parent, and one directory.attribute.key.update.success event for each key you change.
12. Before and after audit log
1
Open the update event
Select the Describe/Manage Audit Log option and choose the most recent update event.
prv audit-log:describe --id=AUDIT_LOG_ID
The event records who did what and when. Along with the event type, the message, and the actor’s name, handle, and session, it records which key changed and the value on both sides of the change.
Every field that changes is recorded in the audit log, rather than only an updated-at timestamp. None of the relationships with the users changed, because the users are tied to the directory attribute based on the ID and foreign key relationship associated with the policy ruleset that the attribute is mapped to.Select the View/Manage Logs for Same Record option to go back to the list of audit logs for the attribute.
13. View policy users after the rename
1
Re-run the policy user list
The same command runs against the same ruleset and returns the same 20 people.
The resource.handle column now shows the new handle for every row, and the user.org.title column still shows the old job title, because that column comes out of the Identity Provider data rather than your attribute data.
You may be filtering on different names over time as your organization evolves. Provisionr keeps track of the names, and the people stay tied to the relationship instead of the string.
14. Read audit logs for a policy user
1
Open the audit log list
Describe a policy user from that list and select the View Audit Logs for this Policy User option, then select the View Logs for this Record log type.
prv audit-log:list --record_id=POLICY_USER_ID
There is one policy.user.create.success event, and its parent is the directory attribute that the user was attached to.
2
Describe the create event
Describe that event to see how the user came to be on the list.
event_type policy.user.create.successmessage Policy User Qualified and Added to Manifestmetadata.conditions.pocon_01abc123... User Okta identities where title equals IT Security Engineeractor_source webparent_type directory_attributeparent_id dratr_01abc123...record_type policy_userrecord_id pousr_01abc123...related_id porul_01abc123...related_type policy_rulesubject_id drusr_01abc123...subject_type directory_user
The message tells you that the user qualified and was added to the manifest, and the metadata lists the condition that qualified them in plain language. The actor is the person who initiated the onboarding, because the background job that synced with your Identity Provider was started by them. One of the normal recurring syncs is recorded as a system event instead.Audit logs carry the relationships as well, so you can follow the trail from here. The record is the policy user, the parent is the directory attribute, the subject is the directory user, and the related record is the policy rule that granted them the attribute.
15. Describe a policy rule
1
Describe the rule by ID
You can paste the related policy rule ID straight into the describe command instead of walking back through the menus.
prv policy-rule:describe --id=POLICY_RULE_ID
2
Review the rule
The rule shows the role it grants, that it was imported, the justification description, how many days after which the grant expires, and its priority. The metadata.integration_id value carries the prefix of the integration it came from, so you can tell which provider created the rule.Keep in mind that metadata.attribute_name and metadata.attribute_handle still hold the name and handle the rule was created against, even after you renamed the attribute. The rule keeps a record of what it originally matched, while the relationship it created continues to point at the current attribute.You can use the Next Step menu to navigate to related records, child relationship conditions, manifest users, and audit logs.
16. View conditions for a rule
1
View the rule's conditions
Select the View/Manage Conditions option to see the conditions a user has to match for the rule to apply to them.
Condition Records type identity profile_key title profile_operator equals profile_value IT Security Engineer is_imported true
2
What to look for
Each condition shows its type, the resource it belongs to, the profile key, the operator, the value, and whether it was imported.
17. List the rules on the ruleset
1
List the ruleset's rules
Select Describe/Manage a Parent Relationship and choose Policy Ruleset. Use the Next Step menu to select View/Manage Rules.
Right now there is a single imported rule, with one condition and 20 manifest users. If your organization is about to rename these job titles, you can add a rule to the same ruleset ahead of the change.
18. Create a policy rule
1
Start the create wizard
Use the Next Step menu to select the Create Policy Rule option.
Select the role that this rule grants (member), then answer whether you want to add a justification description.Answer Yes and type your justification into the multi-line input, then press CTRL+D to submit it. This is the audit justification of what the rule is and why it exists.
A rule does not have a description by default unless it was imported during Integration sync for a Dimension Attribute.It is a best practice to include a change/request/service/support ticket ID or number that can be used to help locate the original request.You can use a sentence or two for a justification message that will make sense to audit and compliance team members during user access reviews.
19. Add a condition to the rule
1
Choose the condition type
The wizard continues into the condition for the new rule.You can choose the condition that users need to match. You can map users that already have an attribute, users that report to a certain manager, any string match in the identity metadata, or a named user as an exception when they do not match any of the other criteria.
┌ Select a Condition Type ───────────┐│ ○ Users attached to an Attribute ││ ○ Users reporting to a Manager ││ › ● Identity Metadata String Match ││ ○ Named User │└────────────────────────────────────┘
2
Configure the string match
Select the Identity Metadata String Match option, then select the Title dimension.You can match on contains or equals, and you can use greater-than or prefix comparisons when you are working with date or integer values. Select the equals operator and enter the value that your Identity Provider will send after the job title change: Security Engineer.Your changes are listed for review before they are saved, including the rule the condition belongs to, the integration, the profile key, the operator, and the value. Save your changes.
3
Confirm the empty match
No users match this condition because the upstream HRIS change has not happened yet. The CLI will stop and ask you to confirm that this is what you intended, so a typo does not go in unnoticed. You can delete the rule and start over if it was a mistake, or confirm it and continue. You are then asked whether you want to add another condition to the rule.
You can only add or remove conditions while the rule is in a staged (draft) state. No users will be granted access while the rule is in a staged state.You can activate your rule when you are finished adding conditions, have reviewed the list of staged users, and are ready to grant users access to the Directory Attribute and any resources that have the Attribute added to the respective policy ruleset.Active rules are read-only (their conditions cannot be changed). You can duplicate the rule to make a new revision in a staged state. You can also deprecate (schedule expiration) or deactivate the existing rule at any time if you have been granted the appropriate permission.
20. Activate the policy rule
1
Run the activate command
The rule is staged and is not in effect yet. You can activate it now or come back and activate it later.
prv policy-rule:activate --id=POLICY_RULE_ID
The current values of the rule are listed, including its staged state and its empty activated-at timestamp, followed by what activating it means.
Impact of DecisionYou 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.
2
Confirm activation
Answer Yes to the activation prompt and the CLI confirms that the policy rule was activated successfully. Since you know the change is coming, activating the rule now means that no one is impacted at the cutover.
Once a rule has been activated, its conditions cannot be changed. You can duplicate the rule to create a new staged version, and you can deprecate or deactivate the existing rule.
21. Review two rules on one ruleset
1
List the rules again
Navigate back to the ruleset and list the rules again.
There are now two active rules on the ruleset. The imported rule has 20 manifest users, and the rule you just created has none, because the job titles have not been renamed in your Identity Provider yet. When the change is made and the next sync runs, the users move from the first rule to the second one.The attribute has already been renamed, and none of the policies, groups, or resources tied to it have changed, since the relationship is associated with the ID, not the string.
3
Explore from here
Take a few minutes to move through the rest of the Next Step menu with the arrow keys and see where you can navigate from here.
22. Export the policy rules
1
Open the export option
Select the Export Results to File or Spreadsheet option to take the rules with you. The export command for policy rules takes no arguments when you run it from this menu.
prv policy-rule:export
2
Select the keys or cancel
The same selection box is presented, with the rule and ruleset keys at the top and the links. keys for the conditions, the ruleset, the resource, the manifest users, the qualified users, and the staged users further down. Remember to scroll down through the whole list, because there is a lot of detail available below the first screen.Press ENTER/RETURN to submit your selection, or press CTRL+C if you decide not to export after all. The options you had selected are struck through inside a red box, the CLI prints ⚠ Cancelled., and you are returned to your terminal.
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/attributes","slug":"/runbooks/orientation/attributes","pageMetadata":{"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"},"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: \"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.\"\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:`Now that your Identity Provider (IdP) mappings are configured, you can explore the full directory of users that were imported and see how Provisionr ties each person to attributes, policy users, and rules through IDs rather than fragile strings.`}),`\n`,_jsxs(_components.p,{children:[`This walkthrough follows one example user — `,_jsx(_components.strong,{children:`Grant Keyes`}),`, an `,_jsx(_components.code,{children:`IT Security Engineer`}),` — from a simple filtered list all the way through to creating and activating a new policy rule.`]}),`\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:`Filter and export directory users by exact string values and by relationships.`}),`\n`,_jsx(_components.li,{children:`Trace how a user connects to attributes, policy users, and rules through stable IDs instead of fragile strings.`}),`\n`,_jsx(_components.li,{children:`Rename an attribute without breaking any of the policies, groups, or resources tied to it.`}),`\n`,_jsx(_components.li,{children:`Read audit logs to see who changed what, when, and the before-and-after values.`}),`\n`,_jsx(_components.li,{children:`Create, add conditions to, and activate a new policy rule ahead of an upstream change.`}),`\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`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`The IDs shown below (`,_jsx(_components.code,{children:`drusr_…`}),`, `,_jsx(_components.code,{children:`dratr_…`}),`, `,_jsx(_components.code,{children:`poset_…`}),`, 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-filter-list-of-users-by-string`,children:`1. Filter list of users by string`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`List the directory users`,children:[_jsx(_components.p,{children:`Start by listing every directory user that has been imported.`}),_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(_components.p,{children:`Below the table you can see the count of active records, expiring records, and total records in your directory.`})]}),_jsxs(Step,{title:`Open the filter menu`,children:[_jsxs(_components.p,{children:[`In the `,_jsx(_components.strong,{children:`Next Step`}),` menu, press the `,_jsx(`kbd`,{children:`↓`}),` arrow or `,_jsx(`kbd`,{children:`TAB`}),` to move the radio option to `,_jsx(_components.strong,{children:`Filter List of Results`}),` and press `,_jsx(`kbd`,{children:`ENTER`}),`/`,_jsx(`kbd`,{children:`RETURN`}),`.`]}),_jsx(CodeBlock,{numberOfLines:`13`,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:`13`,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 Directory User │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ Filter by Attribute, Group, or Resource │`})}),`\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:`│ ○ Run Same Command (to get refreshed results) │`})}),`\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:`Choose the filter method`,children:[_jsxs(_components.p,{children:[`You can search for exact or partial values, run a global search across all fields, or filter by boolean or date values. Leave `,_jsx(_components.strong,{children:`Filter by an exact value in specific field`}),` selected and press `,_jsx(`kbd`,{children:`ENTER`}),`/`,_jsx(`kbd`,{children:`RETURN`}),`.`]}),_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:`┌ Filter Method ───────────────────────────────────────────────┐`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ › ● Filter by an exact value in specific field │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ Filter by a partial value in specific field │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ Global search (all fields) for a partial string match │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ Filter by boolean value │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ Filter by date (timestamp before or after specific date) │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ Reset filters to show all records │`})}),`\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 field to filter on`,children:[_jsxs(_components.p,{children:[`You can choose any field that is available in the API results, including ones that aren’t shown in the table. The `,_jsx(_components.code,{children:`org.`}),` fields are a flattened list of the profile attributes that a user has been mapped to.`]}),_jsxs(_components.p,{children:[`Press the `,_jsx(`kbd`,{children:`↓`}),` arrow or `,_jsx(`kbd`,{children:`TAB`}),` until the radio option highlights `,_jsx(_components.code,{children:`org.title`}),` and press `,_jsx(`kbd`,{children:`ENTER`}),`/`,_jsx(`kbd`,{children:`RETURN`}),`.`]}),_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:`┌ Filter by Field Exact Match ────────────────┐`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ id Ex. drusr_01kytjerc9xgyep0wp3qgx45b7 │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ full_name Ex. Aarav Agarwal │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ email Ex. [email protected] │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ org.dept Ex. Product Development │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ › ● org.title Ex. Software Engineer │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ manager.full_name Ex. Rahul Reddy │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ first_name Ex. Aarav │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ last_name Ex. Agarwal │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ username Ex. aagarwal │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ employee_id_alt │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ deleted │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ state Ex. active │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`└─────────────────────────────────────────────┘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})]}),_jsxs(Step,{title:`Choose the value`,children:[_jsx(_components.p,{children:`Every value that exists for that field is listed, so you do not have to remember how the string is spelled. This list is scrollable and searchable.`}),_jsxs(_components.p,{children:[`Press the `,_jsx(`kbd`,{children:`↓`}),` arrow or `,_jsx(`kbd`,{children:`TAB`}),` several times to scroll down through the results. You will notice the scroll bar on the right-hand side move down.`]}),_jsx(CodeBlock,{numberOfLines:`16`,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:`16`,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:`│ │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`├────────────────────────────────┤`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ › Account Executive │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ Accountant │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ Customer Success Manager │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ Director, Engineering │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ Director, Operations │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ Director, Sales │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ Engineering Manager │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ Finance Manager │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ IT Manager │`})}),`\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,{})})]})})}),_jsxs(_components.p,{children:[`The empty row below the box title is a search input, so you can type part of a word, a full word, or the entire string to narrow the list. Type the word `,_jsx(_components.code,{children:`engineer`}),`, then use the `,_jsx(`kbd`,{children:`↑`}),` or `,_jsx(`kbd`,{children:`↓`}),` arrows to move to the value you want. Select `,_jsx(_components.strong,{children:`IT Security Engineer`}),` and press `,_jsx(`kbd`,{children:`ENTER`}),`/`,_jsx(`kbd`,{children:`RETURN`}),`.`]}),_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:`┌ Filter by Directory User ────────────────────────────────────┐`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ engineer │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`├──────────────────────────────────────────────────────────────┤`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ Director, Engineering │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ Engineering Manager │`})}),`\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:`│ Senior Software Engineer │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ Software Engineer │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ Staff Engineer │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ VP, Engineering │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`└──────────────────────────────────────────────────────────────┘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})]}),_jsxs(Step,{title:`Copy the generated command`,children:[_jsx(_components.p,{children:`You will see a table of results for users with the filtered job title. Scroll to the top of the table and you will see that any applied filter(s) are shown below the command header, so you can copy and paste the CLI command with the arguments to get the same results without using the filter menu.`}),_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`]})})})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`2-add-a-second-filter`,children:`2. Add a second filter`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Apply the manager filter`,children:[_jsx(_components.p,{children:`These users all share a job title, but they are not all on the same team. Let’s filter this down to just the people on the same team as Grant Keyes.`}),_jsxs(_components.p,{children:[`In the table, locate the `,_jsx(_components.code,{children:`manager.full_name`}),` column and take note of Grant Keyes’s manager. Select the `,_jsx(_components.strong,{children:`Filter List of Results`}),` option again, leave `,_jsx(_components.strong,{children:`Filter by an exact value in specific field`}),` selected, choose the `,_jsx(_components.code,{children:`manager.full_name`}),` field, and select the manager from the value list.`]})]}),_jsxs(Step,{title:`Review the combined command`,children:[_jsxs(_components.p,{children:[`After the second filter is applied, both filters are shown in the command above the table. Keep in mind that the manager filter is written as `,_jsx(_components.code,{children:`included.user_manager.full_name`}),`, which is the API path for the related manager record rather than the `,_jsx(_components.code,{children:`manager.full_name`}),` label shown in the field menu that was shortened for terminal column-width brevity.`]}),_jsx(CodeBlock,{filename:``,numberOfLines:`3`,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:`3`,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:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_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'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --where=included.user_manager.full_name=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'Wren Odell'`})]}),`\n`]})})}),_jsx(_components.p,{children:`You now have 9 records, which are the users with the IT Security Engineer title who report to Wren Odell.`})]})]}),`\n`,_jsxs(Tip,{children:[_jsx(_components.p,{children:`This is an example of string matching that is historically used for group rules. String rules commonly break, and users lose access, when the strings are changed upstream in your HRIS or IdP.`}),_jsx(_components.p,{children:`If you can define the string matching in a single source of truth and use IDs when working with group rules and policy conditions, it will be easier to handle changes from upstream data sources.`})]}),`\n`,_jsx(Heading,{level:`2`,id:`3-export-records`,children:`3. Export records`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Open the export option`,children:[_jsx(_components.p,{children:`You can export this filtered set of users to a CSV, JSON, or YAML file that you can import into Google Sheets, Microsoft Excel, an audit evidence platform, or another tool of your choice.`}),_jsxs(_components.p,{children:[`In the `,_jsx(_components.strong,{children:`Next Step`}),` menu, select the `,_jsx(_components.strong,{children:`Export Results to File or Spreadsheet`}),` option.`]}),_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:`┌ 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 Directory User │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ Filter by Attribute, Group, or Resource │`})}),`\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:`│ ○ 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:`Choose columns and format`,children:[_jsxs(_components.p,{children:[`You can choose which columns/keys to include in the spreadsheet. Use the arrow keys to scroll down to see all of the options. Press `,_jsx(`kbd`,{children:`SPACE`}),` to check or uncheck a column.`]}),_jsxs(_components.p,{children:[`Press `,_jsx(`kbd`,{children:`ENTER`}),`/`,_jsx(`kbd`,{children:`RETURN`}),` to save your selection, then use the arrow keys to select CSV. Your CSV file will be saved to the `,_jsx(_components.code,{children:`~/Downloads/provisionr`}),` folder, which is created if it does not exist already. Each file export is timestamped.`]})]}),_jsxs(Step,{title:`Export other resources (optional)`,children:[_jsx(_components.p,{children:`Almost every resource list command has an export command as well, to let you export all records easily. If you want to apply filters, you can use the list command to filter the records or use CLI arguments for the export command.`}),_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:export`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --help`})]}),`\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:` list`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` |`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:` grep`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` export`})]}),`\n`]})})})]})]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`The export command is restricted to users with the export permission for the respective resource, to avoid unintended data exfiltration.`})}),`\n`,_jsx(Heading,{level:`2`,id:`4-filter-by-an-attribute`,children:`4. Filter by an attribute`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Open the attribute filter`,children:[_jsx(_components.p,{children:`Now that you’ve seen how to filter based on strings, let’s filter based on relationships.`}),_jsxs(_components.p,{children:[`Based on what you’ve learned so far, get a list of users, use the `,_jsx(_components.strong,{children:`Next Step`}),` menu to select `,_jsx(_components.strong,{children:`Filter by Attribute, Group, or Resource`}),`, and select the `,_jsx(_components.strong,{children:`Directory Attribute`}),` option.`]}),_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,{numberOfLines:`13`,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:`13`,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 Directory User │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ › ● Filter by Attribute, Group, or Resource │`})}),`\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:`│ ○ Run Same Command (to get refreshed results) │`})}),`\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,{})})]})})}),_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:`┌ Select a Ruleset Type ───┐`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`├──────────────────────────┤`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ › Directory Attribute │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ Google Workspace Group │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ Okta Group │`})}),`\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 Title dimension`,children:[_jsxs(_components.p,{children:[`A dimension was created for each of the profile keys imported from the Identity Provider. Select the `,_jsx(_components.strong,{children:`Title`}),` dimension.`]}),_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:`┌ 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_01kz4gn9k4f1a2ypncpt6kc82s - okta - Cost Center - cost-center - 3 │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ drdim_01kz4gn9ma5myxrm2vkv5fvgcf - okta - Country Code - country-code - 14 │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ drdim_01kz4gn9kkzdcafqmc31jgvdev - okta - Department - dept - 9 │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ drdim_01kz4gn9kc3zjgbkave1h4476b - okta - Division - division - 4 │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ drdim_01kz4k8q18ehy429092ra21qfs - n/a - Functional Teams - func-team - 64 │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ drdim_01kz4gp3f2mk4bvbt0ab4cgfzf - okta - Region - region - 8 │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ drdim_01kz4h4h2ymmntaxkt9jns4bn9 - n/a - Sales Geo - sales-geo - 1 │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ drdim_01kz4gtk6r10q1d18951ryxvj9 - n/a - Sales Manager Team - sales-mgr-team - 1 │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ drdim_01kz4gq4bjkq7vd2t127cna0cw - okta - Sales Region - sales-region - 11 │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ › drdim_01kz4gn9kv339rb1rwr5p8jmd0 - okta - Title - title - 30 │`})}),`\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 attribute`,children:[_jsx(_components.p,{children:`The attribute list shows every unique value that exists for that dimension (profile key) across all users. Each row shows the attribute ID, the integration vendor, the dimension handle, the attribute name, the attribute handle, and the number of users mapped to it. This list is searchable as well.`}),_jsxs(_components.p,{children:[`Select the attribute for the same `,_jsx(_components.code,{children:`IT Security Engineer`}),` job title you filtered on above.`]}),_jsx(CodeBlock,{numberOfLines:`16`,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:`16`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`┌ Select an 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_01kytjhpws0x975jdsaf6hcp89 - n/a - title - Accountant - accountant - 40 │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ dratr_01kytjhps6p0x4h7rnchpzf7kg - n/a - title - Account Executive - acct-exec - 162 │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ dratr_01kytjhq09zakpr5bzhbrh814e - n/a - title - Customer Success Manager - customer-success-mgr - 90 │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ dratr_01kytjhq3t6x6xss3wb8pn1600 - n/a - title - Director, Engineering - dir-eng - 12 │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ dratr_01kytjhq7rxnbegrsc11hzgwds - n/a - title - Director, Operations - dir-ops - 8 │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ dratr_01kytjhqb0ybxq9p38jbbg4hak - n/a - title - Director, Sales - dir-sales - 10 │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ dratr_01kytjhqe1px7mg9z1gv3ffcap - n/a - title - Engineering Manager - eng-mgr - 44 │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ dratr_01kytjhqhks87r6waan672h4x8 - n/a - title - Finance Manager - fin-mgr - 13 │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ dratr_01kytjhqn9ahe3qh291hnwqjpa - n/a - title - IT Manager - it-mgr - 8 │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ › dratr_01kytjhqrqqx8zmczjtpmampy9 - n/a - title - IT Security Engineer - it-sec-eng - 20 │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`└─────────────────────────────────────────────────────────────────────────────────────────────────────────┘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` Press Ctrl+U to undo and choose a different dimension`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})]})]}),`\n`,_jsxs(Tip,{children:[_jsx(_components.p,{children:`Every user, dimension, attribute, policy ruleset, rule, condition, and mapping has a database row in Provisionr with its own lifecycle — a created-at, activated-at, expires-at, and deactivated-at timestamp. That lets you see when a user joined an attribute and when they left it, instead of only knowing that a string is different today than it was before.`}),_jsx(_components.p,{children:`You are seeing a list of Directory Attributes that have a foreign key matching the ID of the Title dimension.`})]}),`\n`,_jsx(Heading,{level:`2`,id:`5-understand-policy-users`,children:`5. Understand policy users`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`List the ruleset's policy users`,children:[_jsx(_components.p,{children:`Selecting the attribute shows a list of policy users for the ruleset that belongs to that attribute.`}),_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`]})})})]}),_jsxs(Step,{title:`Review the policy user records`,children:[_jsxs(_components.p,{children:[`A policy user record is the mapping between one directory user and one resource. The `,_jsx(_components.code,{children:`resource.parent`}),` column is the dimension, in this case `,_jsx(_components.code,{children:`title`}),`, and the `,_jsx(_components.code,{children:`resource.handle`}),` column is the attribute itself. The `,_jsx(_components.code,{children:`rule.id`}),` column tells you which rule caused the user to be attached to that resource.`]}),_jsx(_components.p,{children:`The same 20 people you saw with the exact-value filter are here, and each one now has a record with its own state and its own timestamps.`})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`6-export-the-policy-users`,children:`6. Export the policy users`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Open the export option`,children:[_jsxs(_components.p,{children:[`In the `,_jsx(_components.strong,{children:`Next Step`}),` menu, select the `,_jsx(_components.strong,{children:`Export Results to File or Spreadsheet`}),` option to take this data into a spreadsheet, an audit platform, or your own data set as evidence of where each mapping came from.`]}),_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:export`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --policy_ruleset_id=POLICY_RULESET_ID`})]}),`\n`]})})})]}),_jsxs(Step,{title:`Select the keys to include`,children:[_jsxs(_components.p,{children:[`You choose which keys to include. Press `,_jsx(`kbd`,{children:`SPACE`}),` to check or uncheck an option, use the `,_jsx(`kbd`,{children:`↑`}),` and `,_jsx(`kbd`,{children:`↓`}),` arrows to scroll, and press `,_jsx(`kbd`,{children:`ENTER`}),`/`,_jsx(`kbd`,{children:`RETURN`}),` to submit. The count of selected keys is shown in the box as you go.`]}),_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:`┌ Select attributes to export ──────────────────────┐`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ◼ directory_user.full_name Ex. Alberto Mendoza │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ › ● directory_user.email Ex. [email protected] │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ directory_user.username Ex. amendoza │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ directory_user.badge_id │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ directory_user.employee_id Ex. 02f67a7c │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ directory_user.employee_alt_id │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ directory_user.org.cost-center Ex. G\u0026A │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ directory_user.org.country-code Ex. ES │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ directory_user.org.dept Ex. IT │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ directory_user.org.division Ex. Operations │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`└─────────────────────────────────────── 9 selected ┘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` Press SPACE to select, up and down arrow to scroll, RETURN to submit`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsx(_components.p,{children:`Notice the scroll bar on the right-hand side of the box. The directory user fields are at the top, followed by the policy rule fields.`}),_jsx(_components.p,{children:`Enable the checkboxes for the following columns and export the CSV file.`}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`timestamp.created_at`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`timestamp.expires_at`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`policy_rule.role_handle`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`policy_rule.description`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`policy_resource.name`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.code,{children:`policy_resource.profile_value`})}),`\n`]})]})]}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`You now have the policy data with the date the user was associated with the attribute, the justification message for the rule with the conditions they qualified for, and the current Provisionr attribute name and Identity Provider profile key value for correlation reference.`})}),`\n`,_jsx(Heading,{level:`2`,id:`7-copy-a-command-from-the-output`,children:`7. Copy a command from the output`}),`\n`,_jsx(Steps,{children:_jsxs(Step,{title:`Reuse a printed command`,children:[_jsx(_components.p,{children:`Every command is printed above its output, including the commands the wizard ran for you. Scroll up in your terminal, copy the policy user list command, and paste it to come back to the same list without walking through the menus again.`}),_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`]})})})]})}),`\n`,_jsx(Heading,{level:`2`,id:`8-describe-a-policy-user`,children:`8. Describe a policy user`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Open the policy user record`,children:[_jsxs(_components.p,{children:[`Select the `,_jsx(_components.strong,{children:`Describe/Manage Policy User`}),` option and select Grant Keyes in the list.`]}),_jsx(_components.p,{children:`The first panel is the policy user record itself, with the state and the timestamps for when it was created, updated, activated, and when it expires or was deleted.`}),_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:`Policy User`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` id pousr_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:` timestamp.created_at 2026-07-30 22:35 UTC (34m)`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` timestamp.updated_at 2026-07-30 22:35 UTC (34m)`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` timestamp.activated_at 2026-07-30 22:35 UTC (34m)`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` timestamp.expires_at`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` timestamp.deleted_at`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})]}),_jsxs(Step,{title:`Review the related records`,children:[_jsx(_components.p,{children:`Scroll down and you will see the panels for each record in the relationship.`}),_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`The directory user panel is the profile data you have already seen.`}),`\n`,_jsx(_components.li,{children:`The policy rule panel shows the role the user was granted, whether the rule was imported, the justification description, and how many days after which the grant expires.`}),`\n`,_jsx(_components.li,{children:`The policy ruleset panel shows the type of ruleset and the resource it is attached to. The policy resource panel is the attribute itself, with its parent dimension, its name, its handle, and the profile value that came from your Identity Provider.`}),`\n`]}),_jsxs(_components.p,{children:[`The `,_jsx(_components.strong,{children:`Next Step`}),` menu lets you navigate to any of those related records, or read the audit logs for the policy user.`]}),_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:`┌ 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 Directory User │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ View Policy Resource │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ View Policy Rule Conditions │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ View Policy Ruleset │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ View Policy Rule │`})}),`\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 Policy User │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ ○ List of Policy Users │`})}),`\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,{})})]})})})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`9-explore-user-attributes`,children:`9. Explore user attributes`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`List the user's attributes`,children:[_jsxs(_components.p,{children:[`You can explore the Policy User records from the directory user instead of from the attribute. Navigate to the Directory User and select the `,_jsx(_components.strong,{children:`View Attributes, Groups, or Resources`}),` option from the `,_jsx(_components.strong,{children:`Next Step`}),` menu.`]}),_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:` --directory_user_id=DIRECTORY_USER_ID`})]}),`\n`]})})})]}),_jsx(Step,{title:`Review the results`,children:_jsxs(_components.p,{children:[`This lists one policy user record for every attribute the user is attached to, across all of the dimensions that were imported, not only the job title. The `,_jsx(_components.code,{children:`resource.parent`}),` column tells you which dimension each row belongs to.`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`10-update-the-attribute-handle`,children:`10. Update the attribute handle`}),`\n`,_jsx(Steps,{children:_jsxs(Step,{title:`Rename the attribute handle`,children:[_jsxs(_components.p,{children:[`Describe the Policy Resource to navigate to the IT Security Engineer title attribute and select `,_jsx(_components.strong,{children:`Update this Attribute`}),`. Select the `,_jsx(_components.code,{children:`handle`}),` key and enter `,_jsx(_components.code,{children:`sec-eng`}),`, then save the change.`]}),_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:update`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --id=ATTRIBUTE_ID`})]}),`\n`]})})})]})}),`\n`,_jsx(Heading,{level:`2`,id:`11-explore-audit-logs`,children:`11. Explore audit logs`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Open the attribute's audit logs`,children:[_jsxs(_components.p,{children:[`In the `,_jsx(_components.strong,{children:`Next Step`}),` menu, select the `,_jsx(_components.strong,{children:`View Audit Logs for this Attribute`}),` option, then select the `,_jsx(_components.strong,{children:`View Logs for this Record`}),` log 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:` audit-log:list`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --record_id=ATTRIBUTE_ID`})]}),`\n`]})})})]}),_jsx(Step,{title:`What to look for`,children:_jsxs(_components.p,{children:[`The list shows the ID, the timestamp, the actor who made the change, the level, the event type, the parent record, and the record itself. You will see a `,_jsx(_components.code,{children:`directory.attribute.import.success`}),` event from when the attribute was created during the import, with the dimension as its parent, and one `,_jsx(_components.code,{children:`directory.attribute.key.update.success`}),` event for each key you change.`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`12-before-and-after-audit-log`,children:`12. Before and after audit log`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Open the update event`,children:[_jsxs(_components.p,{children:[`Select the `,_jsx(_components.strong,{children:`Describe/Manage Audit Log`}),` option and choose the most recent update event.`]}),_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:` audit-log:describe`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --id=AUDIT_LOG_ID`})]}),`\n`]})})}),_jsx(_components.p,{children:`The event records who did what and when. Along with the event type, the message, and the actor’s name, handle, and session, it records which key changed and the value on both sides of the change.`}),_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:`┌ Audit Log (Truncated) ───────────────────────────────────────────────────┐`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ id wslog_01kz9t2xt7rqnm2nymzzz3x6ts │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ created_at 2026-08-06 18:33 UTC (10s) │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ event_type directory.attribute.key.update.success │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ message Key updated │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ actor_id wsusr_01abc123... │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ actor_name Grant Keyes │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ attribute_key handle │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ attribute_value_old it-sec-eng │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ attribute_value_new sec-eng │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ record_type directory_attribute │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ record_id dratr_01abc123... │`})}),`\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 full context schema`,children:[_jsx(_components.p,{children:`The audit log has a comprehensive context schema based on the event being logged.`}),_jsx(CodeBlock,{numberOfLines:`40`,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:`40`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`┌ Audit Log (Full) ────────────────────────────────────────────────────────┐`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ id wslog_01kz9t2xt7rqnm2nymzzz3x6ts │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ tenant_id wksdvp1tc01r │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ tenant_model App\\\\Models\\\\FederationWorkspace │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ created_at 2026-08-06 18:33 UTC (10s) │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ occurred_at │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ level info │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ event_type directory.attribute.key.update.success │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ method App\\\\Actions\\\\V1\\\\DirectoryAttribute\\\\UpdateAttribute:37 │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ message Key updated │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ errors │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ metadata │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ actor_model App\\\\Models\\\\WorkspaceUser │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ actor_type workspace_user │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ actor_id wsusr_01abc123... │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ actor_name Grant Keyes │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ actor_handle gkeyes │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ actor_session_id udhLSQJ7bCGBc7UfJNIJWcg3I1b9eBrccYqHgTyd │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ actor_source api │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ attribute_key handle │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ attribute_value_old it-sec-eng │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ attribute_value_new sec-eng │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ parent_type │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ parent_id │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ record_type directory_attribute │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ record_id dratr_01abc123... │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ record_provider_id │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ related_id │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ related_type │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ subject_id │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ subject_type │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ count_records │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ job_batch │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ job_id │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ job_platform │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ job_pipeline_id │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ job_timestamp │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`│ job_transaction_id │`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`└──────────────────────────────────────────────────────────────────────────┘`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsx(_components.p,{children:`Every field that changes is recorded in the audit log, rather than only an updated-at timestamp. None of the relationships with the users changed, because the users are tied to the directory attribute based on the ID and foreign key relationship associated with the policy ruleset that the attribute is mapped to.`}),_jsxs(_components.p,{children:[`Select the `,_jsx(_components.strong,{children:`View/Manage Logs for Same Record`}),` option to go back to the list of audit logs for the attribute.`]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`13-view-policy-users-after-the-rename`,children:`13. View policy users after the rename`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Re-run the policy user list`,children:[_jsx(_components.p,{children:`The same command runs against the same ruleset and returns the same 20 people.`}),_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 renamed handle`,children:_jsxs(_components.p,{children:[`The `,_jsx(_components.code,{children:`resource.handle`}),` column now shows the new handle for every row, and the `,_jsx(_components.code,{children:`user.org.title`}),` column still shows the old job title, because that column comes out of the Identity Provider data rather than your attribute data.`]})})]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`You may be filtering on different names over time as your organization evolves. Provisionr keeps track of the names, and the people stay tied to the relationship instead of the string.`})}),`\n`,_jsx(Heading,{level:`2`,id:`14-read-audit-logs-for-a-policy-user`,children:`14. Read audit logs for a policy user`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Open the audit log list`,children:[_jsxs(_components.p,{children:[`Describe a policy user from that list and select the `,_jsx(_components.strong,{children:`View Audit Logs for this Policy User`}),` option, then select the `,_jsx(_components.strong,{children:`View Logs for this Record`}),` log 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:` audit-log:list`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --record_id=POLICY_USER_ID`})]}),`\n`]})})}),_jsxs(_components.p,{children:[`There is one `,_jsx(_components.code,{children:`policy.user.create.success`}),` event, and its parent is the directory attribute that the user was attached to.`]})]}),_jsxs(Step,{title:`Describe the create event`,children:[_jsx(_components.p,{children:`Describe that event to see how the user came to be on the list.`}),_jsx(CodeBlock,{numberOfLines:`13`,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:`13`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`event_type policy.user.create.success`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`message Policy User Qualified and Added to Manifest`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`metadata.conditions.pocon_01abc123... User Okta identities where title equals IT Security Engineer`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`actor_source web`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`parent_type directory_attribute`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`parent_id dratr_01abc123...`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`record_type policy_user`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`record_id pousr_01abc123...`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`related_id porul_01abc123...`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`related_type policy_rule`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`subject_id drusr_01abc123...`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`subject_type directory_user`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsx(_components.p,{children:`The message tells you that the user qualified and was added to the manifest, and the metadata lists the condition that qualified them in plain language. The actor is the person who initiated the onboarding, because the background job that synced with your Identity Provider was started by them. One of the normal recurring syncs is recorded as a system event instead.`}),_jsx(_components.p,{children:`Audit logs carry the relationships as well, so you can follow the trail from here. The record is the policy user, the parent is the directory attribute, the subject is the directory user, and the related record is the policy rule that granted them the attribute.`})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`15-describe-a-policy-rule`,children:`15. Describe a policy rule`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Describe the rule by ID`,children:[_jsx(_components.p,{children:`You can paste the related policy rule ID straight into the describe command instead of walking back through the menus.`}),_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:describe`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --id=POLICY_RULE_ID`})]}),`\n`]})})})]}),_jsxs(Step,{title:`Review the rule`,children:[_jsxs(_components.p,{children:[`The rule shows the role it grants, that it was imported, the justification description, how many days after which the grant expires, and its priority. The `,_jsx(_components.code,{children:`metadata.integration_id`}),` value carries the prefix of the integration it came from, so you can tell which provider created the rule.`]}),_jsxs(_components.p,{children:[`Keep in mind that `,_jsx(_components.code,{children:`metadata.attribute_name`}),` and `,_jsx(_components.code,{children:`metadata.attribute_handle`}),` still hold the name and handle the rule was created against, even after you renamed the attribute. The rule keeps a record of what it originally matched, while the relationship it created continues to point at the current attribute.`]}),_jsxs(_components.p,{children:[`You can use the `,_jsx(_components.strong,{children:`Next Step`}),` menu to navigate to related records, child relationship conditions, manifest users, and audit logs.`]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`16-view-conditions-for-a-rule`,children:`16. View conditions for a rule`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`View the rule's conditions`,children:[_jsxs(_components.p,{children:[`Select the `,_jsx(_components.strong,{children:`View/Manage Conditions`}),` option to see the conditions a user has to match for the rule to apply to them.`]}),_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:`Condition Records`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` type identity`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` profile_key title`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` profile_operator equals`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` profile_value IT Security Engineer`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:` is_imported true`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})]}),_jsx(Step,{title:`What to look for`,children:_jsx(_components.p,{children:`Each condition shows its type, the resource it belongs to, the profile key, the operator, the value, and whether it was imported.`})})]}),`\n`,_jsx(Heading,{level:`2`,id:`17-list-the-rules-on-the-ruleset`,children:`17. List the rules on the ruleset`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`List the ruleset's rules`,children:[_jsxs(_components.p,{children:[`Select `,_jsx(_components.strong,{children:`Describe/Manage a Parent Relationship`}),` and choose `,_jsx(_components.code,{children:`Policy Ruleset`}),`. Use the `,_jsx(_components.strong,{children:`Next Step`}),` menu to select `,_jsx(_components.strong,{children:`View/Manage Rules`}),`.`]}),_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(Step,{title:`Review the rules`,children:_jsx(_components.p,{children:`Right now there is a single imported rule, with one condition and 20 manifest users. If your organization is about to rename these job titles, you can add a rule to the same ruleset ahead of the change.`})})]}),`\n`,_jsx(Heading,{level:`2`,id:`18-create-a-policy-rule`,children:`18. Create a policy rule`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Start the create wizard`,children:[_jsxs(_components.p,{children:[`Use the `,_jsx(_components.strong,{children:`Next Step`}),` menu to select the `,_jsx(_components.strong,{children:`Create Policy Rule`}),` option.`]}),_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`]})})})]}),_jsxs(Step,{title:`Choose the role and justification`,children:[_jsx(_components.p,{children:`Select the role that this rule grants (member), then answer whether you want to add a justification description.`}),_jsxs(_components.p,{children:[`Answer `,_jsx(_components.strong,{children:`Yes`}),` and type your justification into the multi-line input, then press `,_jsx(`kbd`,{children:`CTRL`}),`+`,_jsx(`kbd`,{children:`D`}),` to submit it. This is the audit justification of what the rule is and why it exists.`]})]})]}),`\n`,_jsxs(Note,{children:[_jsx(_components.p,{children:`A rule does not have a description by default unless it was imported during Integration sync for a Dimension Attribute.`}),_jsx(_components.p,{children:`It is a best practice to include a change/request/service/support ticket ID or number that can be used to help locate the original request.`}),_jsx(_components.p,{children:`You can use a sentence or two for a justification message that will make sense to audit and compliance team members during user access reviews.`})]}),`\n`,_jsx(Heading,{level:`2`,id:`19-add-a-condition-to-the-rule`,children:`19. Add a condition to the rule`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Choose the condition type`,children:[_jsx(_components.p,{children:`The wizard continues into the condition for the new rule.`}),_jsx(_components.p,{children:`You can choose the condition that users need to match. You can map users that already have an attribute, users that report to a certain manager, any string match in the identity metadata, or a named user as an exception when they do not match any of the other criteria.`}),_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:`Configure the string match`,children:[_jsxs(_components.p,{children:[`Select the `,_jsx(_components.strong,{children:`Identity Metadata String Match`}),` option, then select the Title dimension.`]}),_jsxs(_components.p,{children:[`You can match on contains or equals, and you can use greater-than or prefix comparisons when you are working with date or integer values. Select the `,_jsx(_components.strong,{children:`equals`}),` operator and enter the value that your Identity Provider will send after the job title change: `,_jsx(_components.code,{children:`Security Engineer`}),`.`]}),_jsx(_components.p,{children:`Your changes are listed for review before they are saved, including the rule the condition belongs to, the integration, the profile key, the operator, and the value. Save your changes.`})]}),_jsx(Step,{title:`Confirm the empty match`,children:_jsx(_components.p,{children:`No users match this condition because the upstream HRIS change has not happened yet. The CLI will stop and ask you to confirm that this is what you intended, so a typo does not go in unnoticed. You can delete the rule and start over if it was a mistake, or confirm it and continue. You are then asked whether you want to add another condition to the rule.`})})]}),`\n`,_jsxs(Note,{children:[_jsx(_components.p,{children:`You can only add or remove conditions while the rule is in a staged (draft) state. No users will be granted access while the rule is in a staged state.`}),_jsx(_components.p,{children:`You can activate your rule when you are finished adding conditions, have reviewed the list of staged users, and are ready to grant users access to the Directory Attribute and any resources that have the Attribute added to the respective policy ruleset.`}),_jsx(_components.p,{children:`Active rules are read-only (their conditions cannot be changed). You can duplicate the rule to make a new revision in a staged state. You can also deprecate (schedule expiration) or deactivate the existing rule at any time if you have been granted the appropriate permission.`})]}),`\n`,_jsx(Heading,{level:`2`,id:`20-activate-the-policy-rule`,children:`20. Activate the policy rule`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Run the activate command`,children:[_jsx(_components.p,{children:`The rule is staged and is not in effect yet. You can activate it now or come back and activate it later.`}),_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(_components.p,{children:`The current values of the rule are listed, including its staged state and its empty activated-at timestamp, followed by what activating it means.`}),_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,{})}),`\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,{})})]})})})]}),_jsx(Step,{title:`Confirm activation`,children:_jsxs(_components.p,{children:[`Answer `,_jsx(_components.strong,{children:`Yes`}),` to the activation prompt and the CLI confirms that the policy rule was activated successfully. Since you know the change is coming, activating the rule now means that no one is impacted at the cutover.`]})})]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Once a rule has been activated, its conditions cannot be changed. You can duplicate the rule to create a new staged version, and you can deprecate or deactivate the existing rule.`})}),`\n`,_jsx(Heading,{level:`2`,id:`21-review-two-rules-on-one-ruleset`,children:`21. Review two rules on one ruleset`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`List the rules again`,children:[_jsx(_components.p,{children:`Navigate back to the ruleset and list the rules again.`}),_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`]})})})]}),_jsxs(Step,{title:`Review the two rules`,children:[_jsx(_components.p,{children:`There are now two active rules on the ruleset. The imported rule has 20 manifest users, and the rule you just created has none, because the job titles have not been renamed in your Identity Provider yet. When the change is made and the next sync runs, the users move from the first rule to the second one.`}),_jsx(_components.p,{children:`The attribute has already been renamed, and none of the policies, groups, or resources tied to it have changed, since the relationship is associated with the ID, not the string.`})]}),_jsx(Step,{title:`Explore from here`,children:_jsxs(_components.p,{children:[`Take a few minutes to move through the rest of the `,_jsx(_components.strong,{children:`Next Step`}),` menu with the arrow keys and see where you can navigate from here.`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`22-export-the-policy-rules`,children:`22. Export the policy rules`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Open the export option`,children:[_jsxs(_components.p,{children:[`Select the `,_jsx(_components.strong,{children:`Export Results to File or Spreadsheet`}),` option to take the rules with you. The export command for policy rules takes no arguments when you run it from this menu.`]}),_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:export`})]}),`\n`]})})})]}),_jsxs(Step,{title:`Select the keys or cancel`,children:[_jsxs(_components.p,{children:[`The same selection box is presented, with the rule and ruleset keys at the top and the `,_jsx(_components.code,{children:`links.`}),` keys for the conditions, the ruleset, the resource, the manifest users, the qualified users, and the staged users further down. Remember to scroll down through the whole list, because there is a lot of detail available below the first screen.`]}),_jsxs(_components.p,{children:[`Press `,_jsx(`kbd`,{children:`ENTER`}),`/`,_jsx(`kbd`,{children:`RETURN`}),` to submit your selection, or press `,_jsx(`kbd`,{children:`CTRL`}),`+`,_jsx(`kbd`,{children:`C`}),` if you decide not to export after all. The options you had selected are struck through inside a red box, the CLI prints `,_jsx(_components.code,{children:`⚠ Cancelled.`}),`, and you are returned to your terminal.`]})]})]})]})}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":"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"}}},"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. Filter list of users by string","slug":"1-filter-list-of-users-by-string","depth":2,"children":[]},{"title":"2. Add a second filter","slug":"2-add-a-second-filter","depth":2,"children":[]},{"title":"3. Export records","slug":"3-export-records","depth":2,"children":[]},{"title":"4. Filter by an attribute","slug":"4-filter-by-an-attribute","depth":2,"children":[]},{"title":"5. Understand policy users","slug":"5-understand-policy-users","depth":2,"children":[]},{"title":"6. Export the policy users","slug":"6-export-the-policy-users","depth":2,"children":[]},{"title":"7. Copy a command from the output","slug":"7-copy-a-command-from-the-output","depth":2,"children":[]},{"title":"8. Describe a policy user","slug":"8-describe-a-policy-user","depth":2,"children":[]},{"title":"9. Explore user attributes","slug":"9-explore-user-attributes","depth":2,"children":[]},{"title":"10. Update the attribute handle","slug":"10-update-the-attribute-handle","depth":2,"children":[]},{"title":"11. Explore audit logs","slug":"11-explore-audit-logs","depth":2,"children":[]},{"title":"12. Before and after audit log","slug":"12-before-and-after-audit-log","depth":2,"children":[]},{"title":"13. View policy users after the rename","slug":"13-view-policy-users-after-the-rename","depth":2,"children":[]},{"title":"14. Read audit logs for a policy user","slug":"14-read-audit-logs-for-a-policy-user","depth":2,"children":[]},{"title":"15. Describe a policy rule","slug":"15-describe-a-policy-rule","depth":2,"children":[]},{"title":"16. View conditions for a rule","slug":"16-view-conditions-for-a-rule","depth":2,"children":[]},{"title":"17. List the rules on the ruleset","slug":"17-list-the-rules-on-the-ruleset","depth":2,"children":[]},{"title":"18. Create a policy rule","slug":"18-create-a-policy-rule","depth":2,"children":[]},{"title":"19. Add a condition to the rule","slug":"19-add-a-condition-to-the-rule","depth":2,"children":[]},{"title":"20. Activate the policy rule","slug":"20-activate-the-policy-rule","depth":2,"children":[]},{"title":"21. Review two rules on one ruleset","slug":"21-review-two-rules-on-one-ruleset","depth":2,"children":[]},{"title":"22. Export the policy rules","slug":"22-export-the-policy-rules","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/provisionr/68f8bc905a4b045e/scripts/lint-frontmatter.js"],"subdomain":"provisionr","siteName":"Provisionr","title":"Explore Users and Attributes - Provisionr","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-13T12:35:42.423Z","originalFileLocation":"runbooks/orientation/attributes.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=\"Browse, filter, and export directory users synced from Okta or Google Workspace, and trace every identity\u0026#x27;s attributes, policy grants, and audit trail 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=\"Explore Users and Attributes - Provisionr\">\u003cmeta data-mint-head property=\"og:description\" content=\"Browse, filter, and export directory users synced from Okta or Google Workspace, and trace every identity\u0026#x27;s attributes, policy grants, and audit trail 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/attributes\">\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=Explore+Users+and+Attributes\u0026amp;description=Browse%2C+filter%2C+and+export+directory+users+synced+from+Okta+or+Google+Workspace%2C+and+trace+every+identity%27s+attributes%2C+policy+grants%2C+and+audit+trail+in+Provis\u0026amp;theme=f6bc4ae197310e5c36fffed9\u0026amp;signature=717cb330e91f0adf5379a9ca63da921b8963d1b64a967972807c0ca9ac165499\">\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=\"Explore Users and Attributes - Provisionr\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Browse, filter, and export directory users synced from Okta or Google Workspace, and trace every identity\u0026#x27;s attributes, policy grants, and audit trail in Provisionr.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://provisionr.mintlify.site/_mintlify/api/og/v2?division=Orientation\u0026amp;title=Explore+Users+and+Attributes\u0026amp;description=Browse%2C+filter%2C+and+export+directory+users+synced+from+Okta+or+Google+Workspace%2C+and+trace+every+identity%27s+attributes%2C+policy+grants%2C+and+audit+trail+in+Provis\u0026amp;theme=f6bc4ae197310e5c36fffed9\u0026amp;signature=717cb330e91f0adf5379a9ca63da921b8963d1b64a967972807c0ca9ac165499\">\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/attributes\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/runbooks/orientation/attributes.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/attributes#webpage\",\"url\":\"https://docs.provisionr.io/runbooks/orientation/attributes\",\"name\":\"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.\",\"dateModified\":\"2026-08-13T12:35:42.423Z\",\"isPartOf\":{\"@id\":\"https://docs.provisionr.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.provisionr.io/runbooks/orientation/attributes#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.provisionr.io/runbooks/orientation/attributes#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Provisionr\",\"item\":\"https://docs.provisionr.io\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Explore Users and Attributes\",\"item\":\"https://docs.provisionr.io/runbooks/orientation/attributes\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.provisionr.io/runbooks/orientation/attributes#article\",\"headline\":\"Explore Users and Attributes\",\"name\":\"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.\",\"url\":\"https://docs.provisionr.io/runbooks/orientation/attributes\",\"mainEntityOfPage\":{\"@id\":\"https://docs.provisionr.io/runbooks/orientation/attributes#webpage\"},\"dateModified\":\"2026-08-13T12:35:42.423Z\",\"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/attributes.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","icon":"folder-tree","href":"/runbooks/orientation/attributes"},{"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"},{"title":"Create Sales Region Attributes","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":"Explore Users and Attributes - Provisionr","buildId":"dpl_GRSyrvXT6FFTpZZTGz5iZPp3D2zE","deploymentId":"dpl_GRSyrvXT6FFTpZZTGz5iZPp3D2zE","dynamics":[],"chunks":[]}