Release Notes: SecureAuth 2.22.0
This article is a summary of new features and changes in the SecureAuth CUSTOMER IDENTITY MANAGEMENT (formerly known as SecureAuth) version 2.22.0.
Release Date: July 31, 2024
Highlights
- Improved B2B Organization Management
This release introduces significant advancements in B2B Organization Management, focusing on productizing features that address B2B delegated administration and Partner Managed Identity use cases. These improvements include enhanced sub-organization management, better visibility and control over organizational hierarchies, and more prominent access to the delegated admin portal, making it easier for business admins to manage complex organizational structures.
- Improved Authentication Security
In the area of authentication security, we have added new MFA capabilities and made substantial improvements to Identity Pools, providing administrators with more control and flexibility in managing multi-factor authentication settings. These enhancements strengthen security and ensure a more robust and secure authentication process across all user interactions.
- User Experience and Interface Enhancements
Additionally, this release brings a series of UX/UI improvements aimed at simplifying the admin portal experience. These minor but impactful changes make the product more intuitive and easier to manage, streamlining daily tasks and improving overall usability for administrators.
Breaking changes
- [AUT-10839]
Use new b2b users apis in B2B Portal
New fine-grained permissions:
{ "read_roles": true, "manage_user_manager_role": true, "get_identity_pool": true, "update_identity_pool": true, "delete_identity_pool": true, "read_identity_pool_users": true, "manage_identity_pool_users": true, "manage_user_passwords": true, "manage_user_otps": true, "manage_user_addresses": true, "manage_user_identifiers": true, "send_user_verification": true, "send_user_activation": true, "b2b_read_users": true, "b2b_manage_users": true, "b2b_read_business_metadata": true, "b2b_manage_business_metadata": true, "b2b_read_admin_metadata": true, "b2b_manage_admin_metadata": true }
Not allowed to create/import users if admin metadata or business metadata contains required fields
- [AUT-11028]
Do not enable JIT by default in the created idp when a workspace has workspace pool.
- [AUT-11085]
Fix a bug where pairwise subject type was incorrectly applied for the following grant types:
jwt bearer
token exchange
password
device
Following this correction, given the absence of user interaction within the specified flow, the public subject type will always be utilized.
- [AUT-11353]
Adjust DPoP logic to the newest openid conformance tests, version: 5.1.17.
Change PAR endpoint status code and error from 401 invalid_dpop_proof to 400 invalid_request when both DPoP proof header and dpop_jkt form param are provided but they do not match
Change Token endpoint status code from 401 to 400 for invalid_dpop_proof errors.
Major Additions and Changes
B2B Organization Improvements
- [AUT-10825] Hierarchy Mode in B2B Organizations Page
A hierarchy mode has been introduced for managing B2B organizations, improving organizational structure visibility and management.
- [AUT-11078] Sub-Organizations Management in Business Admin Mode
Business admins can now manage sub-organizations within an organization, including setting top-level organizations as parents and changing parent organizations for descendants.
- [AUT-11079] Enhanced Parent Organization Management
Allows for the change of the parent organization for top-level organizations and their descendants. Restrictions have been added to ensure the integrity of organizational hierarchies.
- [AUT-11113] Prominent Delegated Admin Portal URL
The URL for the delegated admin portal is now displayed more prominently for easier sharing among customer business admins.
- [AUT-10912] Business Metadata Handling in User/Pool APIs
Added support for handling business metadata in user and pool APIs.
New MFA capabilities
- [ AUT-10883 ] Identity Pool MFA Management
Enhanced management capabilities for MFA settings in Identity Pools.
Enhancements
- [ AUT-11008 ]Configurable IDP Role for Admin Workspace
Admins can now configure IDP roles in the Admin workspace even if Just-In-Time (JIT) provisioning is disabled.
OAuth/OIDC
- [AUT-10786] Correlation ID Support in Authorization Flow
Added support for passing a correlation ID as
authorization_correlation_id
in the OAuth2 authorization flow. All related audit events will now include this ID.- [AUT-11042] Client ID in Software Statement
Allowed the provision of
client_id
in the software statement during Dynamic Client Registration (DCR).- [AUT-11066] No Implicit OpenID Scope for JWT-Bearer Flow
Removed the implicit issuance of the
openid
scope for the JWT-bearer flow even if the client has theopenid
scope.- [AUT-11069] FAPI 2.0 Workspace Updates
Updated FAPI 2.0 workspace to enforce
redirect_uri
for PAR endpoint, withscope
and request object no longer required.- [AUT-10504] OIDC Back-Channel Logout Implementation
Added support for OIDC Back-Channel Logout, improving session management and security.
- [AUT-11087] Token Exchange Support for Azure IDP
Added support for token exchange with Azure Identity Providers (IDP).
- [AUT-11091] Hide Pairwise Identifier Settings
Hidden pairwise identifier settings when grant types do not include authorization code or implicit.
- [AUT-11214] Scope Claim Formats Configuration
Added a configuration to control the formats of scope claims in access tokens. Options include
scp_array
andscope_space_separated
.
Open Banking/Open Data
- [AUT-10829] OBBR Payment Rejection Reasons
Set rejection reasons for payments in version 4 of the OBBR specification, providing clearer feedback on payment issues.
- [AUT-10921] Extended CDR Amend Audit Event
Extended the CDR amend audit event to include previous arrangements when the feature flag
cdr_amend_audit_event_with_previous_arrangement
is enabled.- [AUT-11053] Custom Application Creation in FAPI Workspace
Added functionality to create custom applications in the FAPI workspace.
- [AUT-11094] Remove CDR Amend Audit Event Flag
Removed the
cdr_amend_audit_event_with_previous_arrangement
flag.- [AUT-11144] Configure CDR Arrangements Auto Removal
Allowed configuration of automatic removal of CDR arrangements in the Authorization Server settings.
Extensions and Scripts
- [AUT-10602] Runtime Version Management for Scripts
Introduced a feature flag
scripts_runtime_versions
to manage runtime versions for scripts, with enhanced UI for versioning and extensions.- [AUT-10898] Script Usage View and Migration Support
Added a view to show where specific scripts are used and how to migrate scripts to new runtime versions.
- [AUT-11082] Extended Token Minting Script Example
Updated token minting script example to demonstrate how to access token request parameters.
Identity Pools
- [AUT-10958] Schema Name Migration
Renamed and migrated default metadata and business metadata schema names for consistency.
- [AUT-11022] Improved UI for String Arrays in Schema Editor
Enhanced the user interface for editing string arrays in the schema editor.
- [AUT-10888] JIT Identifier/Address Mapping
Allowed using subject or IDP subject in JIT identifier/address mapping.
Tenant Management
- [AUT-11009] Default User Role Configuration for JIT Users
Enabled configuration of the default user role for JIT-provisioned users in admin workspaces when
roles
andjit_permissions
flags are enabled.- [AUT-11198] Enabled MFA by Default for New Tenants
MFA is now enabled by default for all new tenants.
B2B Organizations
- [AUT-11038] Fine-Grained Permissions in B2B Portal
Enforced fine-grained permissions in the B2B portal, improving control over various user actions.
- [AUT-11099] New Organization Claim Source Type
Added a new type of claim source for organizations.
- [AUT-11254] Breadcrumbs on Sub-organizations View
Added breadcrumbs to the page header with a link to the parent workspace/organization in the Sub-organizations view.
Authorizers and Policies
- [AUT-11035] Default Policy for APIs at Authorizer Level
Introduced a default policy at the authorizer level for APIs. Early access feature
- [AUT-11093] Default Policy for Authorizer
Allowed configuration of the default policy for authorizers during creation and editing, Early access feature.
Audit Logs
- [AUT-11046] New User Identifiers in Audit Logs
Added new user identifiers to audit logs:
idp_subject
,idp_id
,idp_method
,user_id
, anduser_pool_id
.- [AUT-11090] Audit Logs for GitHub Connector Errors
Included details of user-facing errors in audit logs for the GitHub connector, excluding internal errors.
- [AUT-11047] Audit Logs by New User Identifiers
Enabled listing of audit logs by the new user identifiers.
APIs
- [AUT-11116] Admin API for Token Revocation
Added an admin API to revoke various types of tokens (access, refresh, authorization codes, SSO sessions, scope grants) by subject.
- [AUT-11379] Extend tenant configuration APIs to import/export beta feature flags.
The import/export APIs has been extended to include the early access feature flags configuration.
Operations and deployment
- [AUT-10954] Cron Job Cleanup
Cleaned up unused cron jobs, resolving warnings related to missing handlers for specific queues.
- [AUT-11215] Web Templates Rebranding
Updated web templates to reflect the SecureAuth branding.
Bug Fixes
- [AUT-10969] Misleading User Label in Admin Portal
Fixed a misleading "Profile" & "PR" user label in the Admin portal top banner when the email is missing in user info.
- [AUT-10992] Audit Events and Webhooks for Organizations
Added missing audit events and webhooks configuration for organization management.
- [AUT-11032] IDP Provisioning Page Field Correlation
Ensured that obligatory fields from the pool are strictly correlated with the pool schema on the IDP provisioning page.
- [AUT-11041] Schema Mismatch Warning
Added warnings for schema mismatches and allowed changes per user schema in "organization" workspaces.
- [AUT-11051] IDP Pool Selection Pagination
Fixed an issue with missing search or pagination mechanisms when selecting pools in tenants with many pools.
- [AUT-11052] Admin Workspace Access Fix
Resolved issues with accessing the Admin workspace for Workspace Admins.
- [AUT-11061] Pool Selection Issue
Fixed an issue where selecting a pool was not possible if more than one pool existed in a workspace.
- [AUT-11071] Member Label Display
Changed "None" to "Member" for tenant roles and granted tenant member roles on IDP creation in admin workspace.
- [AUT-11077] Organization Hierarchy Display Issue
Fixed the display issue with the parent workspace node for Business Admins in the B2B portal.
- [AUT-11112] User Profile Role Display Issue
Resolved an issue where user roles were sometimes incorrectly displayed as "team_manager" in the B2B Edit User Profile view.
- [AUT-11074] Workspace Roles Mismatch
Addressed mismatches between workspace roles displayed in the user table and user details.
- [AUT-11012] Empty Tenant Role Column
Fixed the issue with the empty tenant role column when the NONE role is assigned.
- [AUT-10743] Role Input Visibility
Hidden or grayed out role input fields when the roles feature is turned off.
- [AUT-11076] Admin Role Change Restriction
Prevented logged-in admin users from changing their own tenant role.
- [AUT-11122] JIT Provisioning Metadata Mapping
Allowed mapping to business admin managed metadata attributes in JIT provisioning.
- [AUT-11237] Issuer URL Calculation for ACS URL
Used
issuer_url
to calculate ACS and Redirect URLs in Identity Providers.- [AUT-11283] Precise Error for Deleted Users
Fixed an issue to return a more precise error when a user is deleted but attempts to use a refresh token.
- [AUT-11315] User Selection in Pool
Resolved the issue preventing auditors from selecting users in the pool.
- [AUT-11352] Remove Code Response Type
Removed the code response type from the partners workspace, which only supports client credentials grant type.
- [SUP-3692] Debtor Account Override for Recurring Payments
Added the ability to override the debtor account for recurring payments in OBBR.