Skip to main content

Use IdP Attributes in FileWave Custom Fields

What

FileWave 16.2 introduces IdP Custom Fields, allowingbring administratorsidentity to pull user and device-specific data directlyattributes from an Identity Provider (IdP) suchinto asFileWave Custom Fields. FileWave 16.2 introduced this provider for Apple devices. Common sources include Okta, Google, Microsoft Entra ID (formerly 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.Keycloak.

When/Why

You would useUse 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.

ThisThe featureIdP reducesremains manualthe source of the attribute values, which avoids maintaining the same user data entryseparately and ensures consistency between your IdP andin FileWave.

⚠️ Platform Supportsupport:: IdP Custom Fields are supported on macOS, iOS, and iPadOS. Windows devices currently do not leverageuse usernamesEnrollment Username for IdP-basedIdP fieldsCustom Fields in the same way they do withuse LDAP.

How

  1. Navigate to Assistants > Custom Fields > Edit Custom Field Definitions in FileWave Central.

  2. Create a new field:

    • Name/Internal Name: DefineEnter asthe withdisplay anyname otherand customstable field.internal name you want to use in reports, Smart Groups, profiles, or API work.

    • Provided By: Select IdP.

    • Assigned to all devices: Usually checkSelect this to ensurewhen the field appliesshould apply across yourthe environment.environment; otherwise scope it to the devices that need the value.

     

  3. Set the Data Type (commonly String).

  4. In the IdP Reference, section, specifyenter the Attribute JSONPath supplied this should match the attribute name fromby your IdPIdP, (e.g.such as email, emaildisplayName, displayName,or department).
    FileWave Admin 2025-10-03 10.51.41.pngIdP Custom Field definition in FileWave Central

  5. Save the Custom Field.

  6. Ensure that devices are linked to users:

    • FileWave usesmatches theIdP data to a device through its Enrollment Username field to associate IdP data with a device..

    • ThisSet canthe be setusername manually (right-clickwith device > Set Enrollment Username)Username, automaticallycollect viait during ADE enrollment,enrollment, or supply it through API/an API or import methods.workflow.