- 0 minutes to read

Claims Overview

Gain complete control of your authorization Claims in Nodinite v7. This page guides you through managing, adding, editing, deleting, and restoring Claims—the building blocks of OIDC/OAuth 2.0 authorization.

✅ Centralized management of all Claims
✅ Inline editing for quick Claim creation
✅ Track which Policies use each Claim
✅ Powerful filtering and search capabilities

Note

Claims are only available when Nodinite is configured for OIDC/OAuth 2.0 authentication mode. For Windows authentication mode, use Users and Windows AD Groups instead.

Get started now: Add or manage Claim user guide.

The Claims Overview in the Access Management menu is where a Nodinite Administrator manages Claims for OIDC/OAuth 2.0 authorization.

This page focuses on managing the list of Claims. For detailed information about how Claims work, authorization flows, and integration patterns, see What is a Claim?

In the Claims Overview, you have a sortable list of defined Claims. You can narrow an extensive list by typing characters into the filter text box.

Claims Overview
The Claims Overview with the list of user-defined Claims.

Manage Claims

The available functionalities for Managing Claims are:

  • Add new Claim - Create Claims with inline editing
  • Edit existing Claim - Modify Key, Value, or Description
  • Delete Claim - Remove Claims (can be restored)
  • Restore deleted Claim - Recover previously deleted Claims
  • Filter the list of Claims - Search by Key, Value, or Description
  • Sort - Order by any column
  • View Usage - See which Policies use each Claim

Add new Claim

Click the "Add Claim" button to create a new Claim using inline editing.

Add Button
Click the "Add Claim" button to create a new Claim with inline editing.

A new row appears where you can enter:

  • Key (Required) - The claim key identifier
  • Value (Required) - The claim value
  • Description (Optional) - A clear description of the Claim's purpose

Click "Save" to create the Claim, or "Cancel" to abort.

Tip

Use consistent lowercase naming for Keys and Values to avoid case-sensitivity issues.

Edit Claim

To Edit an existing Claim, click the Edit button (pencil icon) to the left of the "Actions" button.

Edit Button
Click the Edit button (pencil icon) to modify an existing Claim.

The row enters edit mode where you can modify:

  • Key - Change the claim key
  • Value - Change the claim value
  • Description - Update the description

Click "Save" to apply changes, or "Cancel" to discard.

Warning

Changing the Key or Value creates a new unique combination. Ensure this doesn't duplicate an existing Claim.

Delete Claim

To Delete an existing Claim, open the menu from the "Actions" button and click the "Delete" menu item.

Delete Action Button Menu Item
Click the 'Delete' menu item to delete an existing Claim.

A confirmation modal appears showing:

  • The Claim being deleted
  • Which Policies currently use this Claim
  • Warning about the impact

Important

Deleted Claims remain visible in Policies where they were used (marked with a warning badge). This maintains the audit trail.

Restore deleted Claim

To Restore a deleted Claim, first check the "Include Deleted" checkbox.

When checked, deleted Claims are also presented in the list with a "Deleted" status badge.

Include Deleted Filter
Enable "Include Deleted" to show deleted Claims.

Then open the menu from the "Actions" button and click the "Restore" menu item.

Restore Action Button Menu Item
Click the 'Restore' menu item to restore a deleted Claim.

Filter Claims

Use the search filter at the top of the page to find Claims:

  • Type any text to search across Key, Value, and Description fields
  • Results update in real-time as you type
  • Clear the filter to show all Claims

Search Filter
Use the search filter to find specific Claims.

Sort Claims

Click any column header to sort the list:

  • Key - Alphabetical order
  • Value - Alphabetical order
  • Created - Date/time order
  • Changed - Date/time order

Click again to reverse the sort order (ascending/descending).

View Claim Usage

The "Used In" column shows which Policies reference each Claim:

Used In Column
The "Used In" column displays Policy badges showing where each Claim is used.

  • Policy badges - Clickable links to each Policy
  • Count indicator - "(+N more)" when more than 10 Policies use the Claim
  • Hover tooltip - Shows full list of all Policies
  • Empty - Claim not used in any Policy

Click any Policy badge to navigate to that Policy's detail page.

Tip

Always check the "Used In" column before deleting a Claim to understand the impact on your Policies.

Understanding the Columns

Column Description Sortable
Status Visual indicator - shows "Available" or "Deleted" badge Yes
Key The claim key identifier (e.g., department, access_level) Yes
Value The claim value (e.g., finance, admin) Yes
Description Optional description of the Claim's purpose No
Used In Badges showing which Policies use this Claim No
Created Timestamp when the Claim was created Yes
Changed Timestamp when the Claim was last modified Yes
Actions Dropdown menu with Delete, and Restore options No

Quick Reference

Validation Rules

  • Key/Value combination must be unique - Cannot create duplicates
  • Required fields - Key and Value are mandatory
  • Case-sensitive - department=Finance ≠ department=finance
  • Deleted Claims - Can be restored, remain visible in Policies with warning badge

Tip

For detailed validation rules, naming conventions, and best practices, see What is a Claim?

Frequently Asked Questions

How do I know which Policies use a Claim?

Check the "Used In" column for each Claim. It shows badges for all Policies that reference that Claim. Click any badge to navigate to the Policy details.

Can I edit a Claim that's used in Policies?

Yes, but changing the Key or Value creates a new unique Claim. Changing the Description is always safe. See What is a Claim? for detailed guidance.

What happens when I delete a Claim?

  • Marked as deleted and hidden from main list
  • Remains visible in Policies with warning badge
  • Can be restored at any time
  • Audit trail is preserved

Why can't I create a new Claim?

Possible reasons:

  1. Key/Value combination already exists - Check "Include Deleted"
  2. Missing required field - Both Key and Value required
  3. Insufficient permissions - Need Administrator role
  4. Browser session expired - Refresh and log in

Tip

For conceptual questions about Claims, authorization models, and integration patterns, see What is a Claim?

Troubleshooting

Cannot add Claim - "Already exists" error

  1. Check if Key/Value exists in active list
  2. Enable "Include Deleted" - may have been deleted
  3. Restore instead of creating new if found

Claim doesn't appear in Policy editor

  1. Refresh browser page
  2. Verify Claim was saved successfully
  3. Check if accidentally deleted

Cannot delete Claim

  1. Refresh page and try again
  2. Check browser session hasn't expired
  3. Another administrator may be editing the same Claim

Next Step

Add or manage Claim - Create and manage Claims
What is a Policy? - Learn about Policies
Policies Overview - Manage all Policies

Claims:

What is a Claim? - Understanding Claims
Add or manage Claim - Claim management guide

Policies:

What is a Policy? - Understanding Policies
Policies Overview - Manage all Policies
Add or manage Policy - Policy management guide

Roles:

What is a Role? - Understanding Roles
Roles Overview - Manage all Roles

Access Management:

Access Management - Authorization overview
Install Nodinite v7 - Authentication - Authentication modes
Install Nodinite v7 - OpenID - Configure OIDC/OAuth 2.0

Windows Mode Alternative:

Users - Windows authentication mode
Users Overview - User management
Windows AD Groups - Windows authentication mode
Windows AD Groups - Overview - AD group management