logto/packages/integration-tests/CHANGELOG.md

Change Log

1.9.0

Minor Changes

• 3d3a22030: add support for additional first screen options

  This feature introduces new first screen options, allowing developers to customize the initial screen presented to users. In addition to the existing sign_in and register options, the following first screen choices are now supported:

  • identifier:sign_in: Only display specific identifier-based sign-in methods to users.
  • identifier:register: Only display specific identifier-based registration methods to users.
  • reset_password: Allow users to directly access the password reset page.
  • single_sign_on: Allow users to directly access the single sign-on (SSO) page.

  Example:

  // Example usage (React project using React SDK)
  void signIn({
    redirectUri,
    firstScreen: "identifier:sign_in",
    /**
     * Optional. Specifies which sign-in methods to display on the identifier sign-in page.
     * If not specified, the default sign-in experience configuration will be used.
     * This option is effective when the `firstScreen` value is `identifier:sign_in`, `identifier:register`, or `reset_password`.
     */
    identifiers: ["email", "phone"],
  });
  

Patch Changes

• cc346b4e0: add password policy checking api

  Add POST /api/sign-in-exp/default/check-password API to check if the password meets the password policy configured in the default sign-in experience. A user ID is required for this API if rejects user info is enabled in the password policy.

  Here's a non-normative example of the request and response:

  POST /api/sign-in-exp/default/check-password
  Content-Type: application/json
  
  {
    "password": "123",
    "userId": "some-user-id"
  }
  

  400 Bad Request
  Content-Type: application/json
  
  {
    "result": false,
    "issues": [
      { "code": "password_rejected.too_short" },
      { "code": "password_rejected.character_types" },
      { "code": "password_rejected.restricted.sequence" }
    ]
  }
  

1.8.0

Minor Changes

• 510f681fa: use tsup for building

  We've updated some of the packages to use tsup for building. This will make the build process faster, and should not affect the functionality of the packages.

  Use minor version bump to catch your attention.

Patch Changes

• 3a839f6d6: support organization logo and sign-in experience override

  Now it's able to set light and dark logos for organizations. You can upload the logos in the organization settings page.

  Also, it's possible to override the sign-in experience logo from an organization. Simply add the organization_id parameter to the authentication request. In most Logto SDKs, it can be done by using the extraParams field in the signIn method.

  For example, in the JavaScript SDK:

  import LogtoClient from "@logto/client";
  
  const logtoClient = new LogtoClient(/* your configuration */);
  
  logtoClient.signIn({
    redirectUri: "https://your-app.com/callback",
    extraParams: {
      organization_id: "<organization-id>",
    },
  });
  

  The value <organization-id> can be found in the organization settings page.

  If you could not find the extraParams field in the SDK you are using, please let us know.

• 62f5e5e0c: support app-level branding

  You can now set logos, favicons, and colors for your app. These settings will be used in the sign-in experience when the app initiates the authentication flow. For apps that have no branding settings, the omni sign-in experience branding will be used.

  If organization_id is provided in the authentication request, the app-level branding settings will be overridden by the organization's branding settings, if available.

• d203c8d2f: support experience data server-side rendering

  Logto now injects the sign-in experience settings and phrases into the index.html file for better first-screen performance. The experience app will still fetch the settings and phrases from the server if:

  • The server didn't inject the settings and phrases.
  • The parameters in the URL are different from server-rendered data.

• b188bb161: support multiple app secrets with expiration

  Now secure apps (machine-to-machine, traditional web, Protected) can have multiple app secrets with expiration. This allows for secret rotation and provides an even safer experience.

  To manage your application secrets, go to Logto Console -> Applications -> Application Details -> Endpoints & Credentials.

  We've also added a set of Management APIs (/api/applications/{id}/secrets) for this purpose.

  Important

  You can still use existing app secrets for client authentication, but it is recommended to delete the old ones and create new secrets with expiration for enhanced security.

1.7.0

Minor Changes

• 061a30a87: support agree to terms polices for Logto’s sign-in experiences

  • Automatic: Users automatically agree to terms by continuing to use the service
  • ManualRegistrationOnly: Users must agree to terms by checking a box during registration, and don't need to agree when signing in
  • Manual: Users must agree to terms by checking a box during registration or signing in

Patch Changes

• 87615d58c: support machine-to-machine apps for organizations

  This feature allows machine-to-machine apps to be associated with organizations, and be assigned with organization roles.

  Console

  • Add a new "machine-to-machine" type to organization roles. All existing roles are now "user" type.
  • You can manage machine-to-machine apps in the organization details page -> Machine-to-machine apps section.
  • You can view the associated organizations in the machine-to-machine app details page.

  OpenID Connect grant

  The client_credentials grant type is now supported for organizations. You can use this grant type to obtain an access token for an organization.

  Management API

  A set of new endpoints are added to the Management API:

  • /api/organizations/{id}/applications to manage machine-to-machine apps.
  • /api/organizations/{id}/applications/{applicationId} to manage a specific machine-to-machine app in an organization.
  • /api/applications/{id}/organizations to view the associated organizations of a machine-to-machine app.

• ef21c7a99: support per-organization multi-factor authentication requirement

  An organization can now require its member to have multi-factor authentication (MFA) configured. If an organization has this requirement and a member does not have MFA configured, the member will not be able to fetch the organization access token.

• efa884c40: feature: just-in-time user provisioning for organizations

  This feature allows users to automatically join the organization and be assigned roles upon their first sign-in through some authentication methods. You can set requirements to meet for just-in-time provisioning.

  Email domains

  New users will automatically join organizations with just-in-time provisioning if they:

  • Sign up with verified email addresses, or;
  • Use social sign-in with verified email addresses.

  This applies to organizations that have the same email domain configured.

  To enable this feature, you can add email domain via the Management API or the Logto Console:

  • We added the following new endpoints to the Management API:
    • GET /organizations/{organizationId}/jit/email-domains
    • POST /organizations/{organizationId}/jit/email-domains
    • PUT /organizations/{organizationId}/jit/email-domains
    • DELETE /organizations/{organizationId}/jit/email-domains/{emailDomain}
  • In the Logto Console, you can manage email domains in the organization details page -> "Just-in-time provisioning" section.

  SSO connectors

  New or existing users signing in through enterprise SSO for the first time will automatically join organizations that have just-in-time provisioning configured for the SSO connector.

  To enable this feature, you can add SSO connectors via the Management API or the Logto Console:

  • We added the following new endpoints to the Management API:
    • GET /organizations/{organizationId}/jit/sso-connectors
    • POST /organizations/{organizationId}/jit/sso-connectors
    • PUT /organizations/{organizationId}/jit/sso-connectors
    • DELETE /organizations/{organizationId}/jit/sso-connectors/{ssoConnectorId}
  • In the Logto Console, you can manage SSO connectors in the organization details page -> "Just-in-time provisioning" section.

  Default organization roles

  You can also configure the default roles for users provisioned via this feature. The default roles will be assigned to the user when they are provisioned.

  To enable this feature, you can set the default roles via the Management API or the Logto Console:

  • We added the following new endpoints to the Management API:
    • GET /organizations/{organizationId}/jit/roles
    • POST /organizations/{organizationId}/jit/roles
    • PUT /organizations/{organizationId}/jit/roles
    • DELETE /organizations/{organizationId}/jit/roles/{organizationRoleId}
  • In the Logto Console, you can manage default roles in the organization details page -> "Just-in-time provisioning" section.

1.6.1

Patch Changes

• 5b03030de: Not allow to modify management API resource through API.

  Previously, management API resource and its scopes are readonly in Console. But it was possible to modify through the API. This is not allowed anymore.

1.6.0

Minor Changes

• 468558721: Get organization roles with search keyword.
• cc01acbd0: Create a new user through API with password digest and corresponding algorithm

Patch Changes

• abffb9f95: full oidc standard claims support

  We have added support for the remaining OpenID Connect standard claims. Now, these claims are accessible in both ID tokens and the response from the /me endpoint.

  Additionally, we adhere to the standard scopes - claims mapping. This means that you can retrieve most of the profile claims using the profile scope, and the address claim can be obtained by using the address scope.

  For all newly introduced claims, we store them in the user.profile field.

  ![Note] Unlike other database fields (e.g. name), the claims stored in the profile field will fall back to undefined rather than null. We refrain from using ?? null here to reduce the size of ID tokens, since undefined fields will be stripped in tokens.

1.5.0

Minor Changes

• 31e60811d: use Node 20 LTS for engine requirement.

  Note: We mark it as minor because Logto is shipping with Docker image and it's not a breaking change for users.

Patch Changes

• 9089dbf84: upgrade TypeScript to 5.3.3

1.4.3

Patch Changes

• 9a4da065d: fix incorrect swagger components

1.4.2

Patch Changes

• 1ab39d19b: fix 500 error when using search component in console to filter both roles and applications.

1.4.1

Patch Changes

• f8408fa77: rename the package phrases-ui to phrases-experience
• f6723d5e2: rename the package ui to experience

1.4.0

Minor Changes

• ecbecd8e4: various application improvements

  • Show OpenID Provider configuration endpoint in Console
  • Configure "Rotate Refresh Token" in Console
  • Configure "Refresh Token TTL" in Console

1.3.0

Minor Changes

• 73666f8fa: Provide new features for webhooks

  Features

  • Manage webhooks via the Admin Console
  • Securing webhooks by validating signature
  • Allow to enable/disable a webhook
  • Track recent execution status of a webhook
  • Support multi-events for a webhook

  Updates

  • schemas: add name, events, signingKey, and enabled fields to the hook schema
  • core: change the user-agent value from Logto (https://logto.io) to Logto (https://logto.io/) in the webhook request headers
  • core: deprecate event field in all hook-related APIs, use events instead
  • core: deprecate retries field in the HookConfig for all hook-related APIs, now it will fallback to 3 if not specified and will be removed in the future
  • core: add new APIs for webhook management
    • GET /api/hooks/:id/recent-logs to retrieve recent execution logs(24h) of a webhook
    • POST /api/hooks/:id/test to test a webhook
    • PATCH /api/hooks/:id/signing-key to regenerate the signing key of a webhook
  • core: support query webhook execution stats(24h) via GET /api/hooks/:id and GET /api/hooks/:id by specifying includeExecutionStats query parameter
  • console: support webhook management

• 268dc50e7: Support setting default API Resource from Console and API

  • New API Resources will not be treated as default.
  • Added PATCH /resources/:id/is-default to setting isDefault for an API Resource.
    • Only one default API Resource is allowed per tenant. Setting one API default will reset all others.

1.2.0

Minor Changes

• 9a3aa3aae: Automatically sync the trusted social email and phone info to the new registered user profile

1.1.0

1.0.3

1.0.2

1.0.1

1.0.0

Major Changes

• 1c9160112: Packages are now ESM.

Minor Changes

• f41fd3f05: Replace passcode naming convention in the interaction APIs and main flow ui with verificationCode.

• 343b1090f: Allow admin tenant admin to create tenants without limitation

• f41fd3f05: Officially cleanup all deprecated /session APIs in core and all the related integration tests.

• f41fd3f05: Replace the sms naming convention using phone cross logto codebase. Including Sign-in Experience types, API paths, API payload and internal variable names.

• 402866994: 💥 Breaking change 💥

  Use case-insensitive strategy for searching emails

Patch Changes

• 38970fb88: Fix a Sign-in experience bug that may block some users to sign in.

1.0.0-rc.3

1.0.0-rc.2

1.0.0-rc.1

1.0.0-rc.0

Minor Changes

• f41fd3f0: Replace passcode naming convention in the interaction APIs and main flow ui with verificationCode.
• f41fd3f0: Officially cleanup all deprecated /session APIs in core and all the related integration tests.
• f41fd3f0: Replace the sms naming convention using phone cross logto codebase. Including Sign-in Experience types, API paths, API payload and internal variable names.

1.0.0-beta.19

1.0.0-beta.18

Major Changes

• 1c916011: Packages are now ESM.

1.0.0-beta.17

1.0.0-beta.16

Patch Changes

• 38970fb8: Fix a Sign-in experience bug that may block some users to sign in.

1.0.0-beta.15

1.0.0-beta.14

1.0.0-beta.13

Minor Changes

• 40286699: 💥 Breaking change 💥

  Use case-insensitive strategy for searching emails

All notable changes to this project will be documented in this file. See Conventional Commits for commit guidelines.

1.0.0-beta.12 (2022-10-19)

Note: Version bump only for package @logto/integration-tests

1.0.0-beta.11 (2022-10-19)

Note: Version bump only for package @logto/integration-tests

1.0.0-beta.10 (2022-09-28)

Bug Fixes

• bump react sdk and essentials toolkit to support CJK characters in idToken (2f92b43)

1.0.0-beta.9 (2022-09-07)

⚠ BREAKING CHANGES

• core: load connectors by folder (#1879)

Features

• core: load connectors by folder (#1879) (52b9dd8)

Bug Fixes

• downgrade to sdk 1.0.0-beta.2 (#1896) (91d1bf8)

1.0.0-beta.8 (2022-09-01)

Note: Version bump only for package @logto/integration-tests

1.0.0-beta.6 (2022-08-30)

Note: Version bump only for package @logto/integration-tests

1.0.0-beta.5 (2022-08-19)

⚠ BREAKING CHANGES

• core,console: remove /me apis (#1781)

Code Refactoring

• core,console: remove /me apis (#1781) (2c6171c)

1.0.0-beta.4 (2022-08-11)

Note: Version bump only for package @logto/integration-tests

1.0.0-beta.3 (2022-08-01)

Bug Fixes

• test: run integration test serially (#1676) (8394f7b)

1.0.0-beta.2 (2022-07-25)

Bug Fixes

• test: use demo app to test username-password flow in integration test (#1635) (a258587)

1.0.0-beta.1 (2022-07-19)

Note: Version bump only for package @logto/integration-tests

1.0.0-beta.0 (2022-07-14)

Note: Version bump only for package @logto/integration-tests

1.0.0-alpha.3 (2022-07-07)

Note: Version bump only for package @logto/integration-tests

1.0.0-alpha.1 (2022-07-05)

Note: Version bump only for package @logto/integration-tests

0.1.2-alpha.5 (2022-07-03)

Note: Version bump only for package @logto/integration-tests

0.1.2-alpha.1 (2022-07-02)

Note: Version bump only for package @logto/integration-tests

0.1.1-alpha.0 (2022-07-01)

Features

• shared,phrases-ui: not allow hyphens in username (#1319) (5e81966)