# IdP Custom Fields

## What

FileWave 16.2 introduces <span class="s2">**IdP Custom Fields**</span>, allowing administrators to pull user and device-specific data directly from an Identity Provider (IdP) such as Okta, Google, Entra (Azure AD), or Keycloak into FileWave. These fields work just like other Custom Fields but are powered by your IdP attributes, enabling automation and personalization across devices.

## When/Why

You would use IdP Custom Fields when you want to:

- Dynamically populate user-specific values (e.g., email address, username, department).
- Create Smart Groups based on IdP-sourced information.
- Use variables in configuration profiles (e.g., pre-fill email profiles with the user’s email address).
- Simplify large-scale deployments by automatically binding devices to users through IdP attributes.

This feature reduces manual data entry and ensures consistency between your IdP and FileWave.

<p class="callout danger">⚠️ <span class="s2">**Platform Support**</span>: IdP Custom Fields are supported on <span class="s2">**macOS, iOS, and iPadOS**</span>. Windows devices currently do not leverage usernames for IdP-based fields in the same way they do with LDAP.</p>

## How

1. Navigate to <span class="s1">**Assistants &gt; Custom Fields**</span> &gt; **Edit Custom Field Definitions** in FileWave Central.
2. Create a new field:
    
    
    - <span class="s1">**Name/Internal Name:**</span> Define as with any other custom field.
    - **Provided By:**<span class="s1"> Select </span>**IdP**<span class="s1">.</span>
    - <span class="s1">**Assigned to all devices:**</span> Usually check this to ensure the field applies across your environment.
3. Set the <span class="s1">**Data Type**</span> (commonly <span class="s1">**String**</span>).
4. In the <span class="s1">**IdP Reference**</span> section, specify the <span class="s1">**Attribute JSONPath**</span> — this should match the attribute name from your IdP (e.g., <span class="s2">email</span>, <span class="s2">displayName</span>, <span class="s2">department</span>).  
    [![FileWave Admin 2025-10-03 10.51.41.png](https://kb.filewave.com/uploads/images/gallery/2025-10/scaled-1680-/AT7oXh8YAyDLt6HF-filewave-admin-2025-10-03-10-51-41.png)](https://kb.filewave.com/uploads/images/gallery/2025-10/AT7oXh8YAyDLt6HF-filewave-admin-2025-10-03-10-51-41.png)
5. Save the Custom Field.
6. Ensure that devices are linked to users:
    
    
    - FileWave uses the <span class="s1">**Enrollment Username**</span> field to associate IdP data with a device.
    - This can be set manually (right-click device &gt; Set Enrollment Username), automatically via <span class="s1">**ADE enrollment**</span>, or through <span class="s1">**API/import**</span> methods.

## Related Content

- [Custom Fields in FileWave](https://kb.filewave.com/books/evaluation-guide/page/custom-fields "Custom Fields in FileWave")
- [Working with Groups and Smart Groups](https://kb.filewave.com/books/filewave-anywhere-help-menus/page/working-with-groups-and-smart-groups "Working with Groups and Smart Groups")
- [Using Parameters in Apple iOS/macOS Profiles](https://kb.filewave.com/books/profiles-apple/page/using-parameters-in-apple-iosmacos-profiles "Using Parameters in Apple iOS/macOS Profiles")
- [Apple ADE Enrollment](https://kb.filewave.com/books/evaluation-guide/page/apple-ade-enrollment "Apple ADE Enrollment")