68 KiB
Change Log
1.10.1
Patch Changes
46d0d4c0b
: convert private signing key type from string to JSON object, in order to provide additional information such as key ID and creation timestamp.1ab39d19b
: fix 500 error when using search component in console to filter both roles and applications.- Updated dependencies [
46d0d4c0b
] - Updated dependencies [
1ab39d19b
] - Updated dependencies [
87df417d1
] - Updated dependencies [
d24aaedf5
]- @logto/schemas@1.10.1
- @logto/cli@1.10.1
- @logto/console@1.9.0
- @logto/phrases@1.6.0
- @logto/connector-kit@2.0.0
- @logto/experience@1.2.1
- @logto/shared@3.0.0
1.10.0
Minor Changes
-
03bc7888b
: machine-to-machine (M2M) role-based access control (RBAC)Summary
This feature enables Logto users to apply role-based access control (RBAC) to their machine-to-machine (M2M) applications.
With the update, Logto users can now effectively manage permissions for their M2M applications, resulting in improved security and flexibility.
Following new APIs are added for M2M role management:
Applications
POST /applications/:appId/roles
assigns role(s) to the M2M applicationDELETE /applications/:appId/roles/:roleId
deletes the role from the M2M applicationGET /applications/:appId/roles
lists all roles assigned to the M2M application
Roles
POST /roles/:roleId/applications
assigns the role to multiple M2M applicationsDELETE /roles/:roleId/applications/:appId
removes the M2M application assigned to the roleGET /roles/:roleId/applications
lists all M2M applications granted with the role
Updated following API:
Roles
POST /roles
to specify the role type (eitheruser
ormachine-to-machine
role)
Users
POST /users/:userId/roles
to prevent assigning M2M roles to end-users
-
2c340d379
: supportroles
scope for ID token to issueroles
claim
Patch Changes
- Updated dependencies [
2c340d379
]- @logto/core-kit@2.2.0
- @logto/schemas@1.10.0
- @logto/cli@1.10.0
1.9.2
Patch Changes
-
18181f892
: standardize id and secret generators- Remove
buildIdGenerator
export from@logto/shared
- Add
generateStandardSecret
andgenerateStandardShortId
exports to@logto/shared
- Align comment and implementation of
buildIdGenerator
in@logto/shared
- The comment stated the function will include uppercase letters by default, but it did not; Now it does.
- Use
generateStandardSecret
for all secret generation
- Remove
-
827123faa
: block an identifier from verification for 10 minutes after 5 failed attempts within 1 hour -
Updated dependencies [
a8b5a020f
] -
Updated dependencies [
18181f892
]- @logto/console@1.8.0
- @logto/shared@3.0.0
- @logto/schemas@1.9.2
- @logto/cli@1.9.2
- @logto/core-kit@2.1.2
1.9.1
Patch Changes
- Updated dependencies [
a4b44dde5
] - Updated dependencies [
6f5a0acad
]- @logto/console@1.7.1
- @logto/phrases-experience@1.3.1
- @logto/core-kit@2.1.1
- @logto/experience@1.2.1
- @logto/schemas@1.9.1
- @logto/cli@1.9.1
1.9.0
Minor Changes
-
e8b0b1d02
: feature: password policySummary
This feature enables custom password policy for users. Now it is possible to guard with the following rules when a user is creating a new password:
- Minimum length (default:
8
) - Minimum character types (default:
1
) - If the password has been pwned (default:
true
) - If the password is exactly the same as or made up of the restricted phrases:
- Repetitive or sequential characters (default:
true
) - User information (default:
true
) - Custom words (default:
[]
)
- Repetitive or sequential characters (default:
If you are an existing Logto Cloud user or upgrading from a previous version, to ensure a smooth experience, we'll keep the original policy as much as possible:
The original password policy requires a minimum length of 8 and at least 2 character types (letters, numbers, and symbols).
Note in the new policy implementation, it is not possible to combine lower and upper case letters into one character type. So the original password policy will be translated into the following:
- Minimum length:
8
- Minimum character types:
2
- Pwned:
false
- Repetitive or sequential characters:
false
- User information:
false
- Custom words:
[]
If you want to change the policy, you can do it:
- Logto Console -> Sign-in experience -> Password policy.
- Update
passwordPolicy
property in the sign-in experience via Management API.
Side effects
- All new users will be affected by the new policy immediately.
- Existing users will not be affected by the new policy until they change their password.
- We removed password restrictions when adding or updating a user via Management API.
- Minimum length (default:
-
17fd64e64
: Support region option for s3 storage
Patch Changes
f8408fa77
: rename the packagephrases-ui
tophrases-experience
f6723d5e2
: rename the packageui
toexperience
- Updated dependencies [
e8b0b1d02
] - Updated dependencies [
daf9674b6
] - Updated dependencies [
f8408fa77
] - Updated dependencies [
17fd64e64
] - Updated dependencies [
18e05586c
] - Updated dependencies [
f6723d5e2
] - Updated dependencies [
310698b0d
] - Updated dependencies [
5d78c7271
]- @logto/schemas@1.9.0
- @logto/console@1.7.0
- @logto/phrases@1.5.0
- @logto/phrases-experience@1.3.0
- @logto/core-kit@2.1.0
- @logto/experience@1.2.0
- @logto/cli@1.9.0
- @logto/shared@2.0.1
1.8.0
Patch Changes
0b519e548
: allow non-http origins for application CORS- Updated dependencies [
0b519e548
] - Updated dependencies [
d90b4e7f6
] - Updated dependencies [
ae0ef919f
]- @logto/console@1.6.0
- @logto/schemas@1.8.0
- @logto/cli@1.8.0
1.7.0
Minor Changes
5ccdd7f31
: Record daily active users
Patch Changes
- Updated dependencies [
16d83dd2f
] - Updated dependencies [
5ccdd7f31
] - Updated dependencies [
fde330a8b
]- @logto/console@1.5.1
- @logto/schemas@1.7.0
- @logto/cli@1.7.0
1.6.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
Patch Changes
- Updated dependencies [
ecbecd8e4
] - Updated dependencies [
e9c2c9a6d
] - Updated dependencies [
c743cef42
] - Updated dependencies [
ecbecd8e4
] - Updated dependencies [
cfe4fce51
]- @logto/cli@1.6.0
- @logto/core-kit@2.0.1
- @logto/ui@1.1.5
- @logto/console@1.5.0
- @logto/schemas@1.6.0
- @logto/phrases@1.4.1
- @logto/app-insights@1.3.1
1.5.0
Minor Changes
-
73666f8fa
: Provide new features for webhooksFeatures
- 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
, andenabled
fields to thehook
schema - core: change the
user-agent
value fromLogto (https://logto.io)
toLogto (https://logto.io/)
in the webhook request headers - core: deprecate
event
field in all hook-related APIs, useevents
instead - core: deprecate
retries
field in theHookConfig
for all hook-related APIs, now it will fallback to3
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 webhookPOST /api/hooks/:id/test
to test a webhookPATCH /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
andGET /api/hooks/:id
by specifyingincludeExecutionStats
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 settingisDefault
for an API Resource.- Only one default API Resource is allowed per tenant. Setting one API default will reset all others.
-
fa0dbafe8
: Add custom domain support
Patch Changes
-
ac65c8de4
: ### Enable strict CSP policy check headerThis change removes the report only flag from CSP security header settings, which will enables the strict CSP policy check for all requests.
-
3d9885233
: ## Bump oidc-provider versionBump oidc-provider version to v8.2.2. This version fixes a bug that prevented the revoked scopes from being removed from the access token.
Issued Access Tokens always only contain scopes that are defined on the respective Resource Server (returned from features.resourceIndicators.getResourceServerInfo).
If the scopes are revoked from the resource server, they should be removed from the newly granted access token. This is now fixed in the new version of oidc-provider.
-
813e21639
: Bug fix: reset password webhook should be triggered when the user resets password -
Updated dependencies [
2cab3787c
] -
Updated dependencies [
73666f8fa
] -
Updated dependencies [
268dc50e7
] -
Updated dependencies [
fa0dbafe8
] -
Updated dependencies [
497d5b526
]- @logto/schemas@1.5.0
- @logto/console@1.4.0
- @logto/phrases@1.4.0
- @logto/cli@1.5.0
1.4.0
Minor Changes
-
9a3aa3aae
: Automatically sync the trusted social email and phone info to the new registered user profile -
5d6720805
: add configalwaysIssueRefreshToken
for web apps to unblock OAuth integrations that are not strictly conform OpenID Connect.when it's enabled, Refresh Tokens will be always issued regardless if
prompt=consent
was present in the authorization request.
Patch Changes
5d6720805
: parse requests withapplication/json
content-type for/oidc
APIs to increase compatibility- Updated dependencies [
5d6720805
] - Updated dependencies [
5d6720805
]- @logto/cli@1.4.0
- @logto/console@1.3.0
- @logto/phrases@1.3.0
- @logto/schemas@1.4.0
1.3.1
Patch Changes
5a59cd38e
: Disable pkce requirement for traditional web app- @logto/schemas@1.3.1
- @logto/cli@1.3.1
1.3.0
Minor Changes
-
0023dfe38
: Provide management APIs to help link social identities to user- POST
/users/:userId/identities
to link a social identity to a user - POST
/connectors/:connectorId/authorization-uri
to get the authorization URI for a connector
- POST
Patch Changes
1642df7e1
: add response schemas to swagger.json API- Updated dependencies [
a65bc9b13
] - Updated dependencies [
beb6ebad5
]- @logto/console@1.2.4
- @logto/schemas@1.3.0
- @logto/cli@1.3.0
1.2.3
Patch Changes
046a5771b
: upgrade i18next series packages (#3733, #3743)- Updated dependencies [
046a5771b
]- @logto/console@1.2.3
- @logto/demo-app@1.0.1
- @logto/ui@1.1.4
- @logto/schemas@1.2.3
- @logto/cli@1.2.3
1.2.2
Patch Changes
- Updated dependencies [
4331deb6f
] - Updated dependencies [
748878ce5
]- @logto/app-insights@1.2.0
- @logto/console@1.2.2
- @logto/ui@1.1.3
- @logto/schemas@1.2.2
- @logto/cli@1.2.2
1.2.1
Patch Changes
- Updated dependencies [
352807b16
]- @logto/app-insights@1.1.0
- @logto/console@1.2.1
- @logto/ui@1.1.2
- @logto/schemas@1.2.1
- @logto/cli@1.2.1
1.2.0
Minor Changes
1548e0732
: implement a central cache store to cache well-known with Redis implementation
Patch Changes
-
7af8e9c9b
: Add new management API/users/:userId/password/verify
to help verify user password, which would be helpful when building custom profile or sign-in pages -
6b1948592
: Provide management API to detect if a user has set the password. -
4945b0be2
: Apply security headersApply security headers to logto http request response using (helmetjs)[https://helmetjs.github.io/].
- crossOriginOpenerPolicy
- crossOriginEmbedderPolicy
- crossOriginResourcePolicy
- hidePoweredBy
- hsts
- ieNoOpen
- noSniff
- referrerPolicy
- xssFilter
- Content-Security-Policy
-
Updated dependencies [
6cbc90389
] -
Updated dependencies [
3c84d81ff
] -
Updated dependencies [
ae6a54993
] -
Updated dependencies [
206fba2b5
] -
Updated dependencies [
457cb2822
] -
Updated dependencies [
736d6d212
] -
Updated dependencies [
4945b0be2
] -
Updated dependencies [
c5eb3a2ba
] -
Updated dependencies [
5553425fc
] -
Updated dependencies [
30033421c
] -
Updated dependencies [
91906f0eb
]- @logto/console@1.2.0
- @logto/cli@1.2.0
- @logto/phrases@1.2.0
- @logto/phrases-ui@1.2.0
- @logto/schemas@1.2.0
- @logto/shared@2.0.0
- @logto/ui@1.1.1
- @logto/core-kit@2.0.0
- @logto/connector-kit@1.1.1
- @logto/demo-app@1.0.0
1.1.0
Patch Changes
- Updated dependencies [
f9ca7cc49
] - Updated dependencies [
37714d153
] - Updated dependencies [
f3d60a516
] - Updated dependencies [
5c50957a9
] - Updated dependencies [
e9e8a6e11
] - Updated dependencies [
e2ec1f93e
]- @logto/phrases@1.1.0
- @logto/phrases-ui@1.1.0
- @logto/cli@1.1.0
- @logto/schemas@1.1.0
- @logto/shared@1.0.3
1.0.3
Patch Changes
- Updated dependencies [
5b4da1e3d
]- @logto/schemas@1.0.7
- @logto/cli@1.0.3
- @logto/shared@1.0.2
1.0.2
Patch Changes
- Updated dependencies [
621b09ba1
]- @logto/schemas@1.0.1
- @logto/cli@1.0.2
- @logto/shared@1.0.1
1.0.1
Patch Changes
03ac35e75
: fix applications_roles query- @logto/cli@1.0.1
1.0.0
Major Changes
-
c12717412
: Decouple users and admins💥 BREAKING CHANGES 💥
Logto was using a single port to serve both normal users and admins, as well as the web console. While we continuously maintain a high level of security, it’ll still be great to decouple these components into two separate parts to keep data isolated and provide a flexible infrastructure.
From this version, Logto now listens to two ports by default, one for normal users (
3001
), and one for admins (3002
).- Nothing changed for normal users. No adaption is needed.
- For admin users:
- The default Admin Console URL has been changed to
http://localhost:3002/console
. - To change the admin port, set the environment variable
ADMIN_PORT
. For instance,ADMIN_PORT=3456
. - You can specify a custom endpoint for admins by setting the environment variable
ADMIN_ENDPOINT
. For example,ADMIN_ENDPOINT=https://admin.your-domain.com
. - You can now completely disable admin endpoints by setting
ADMIN_DISABLE_LOCALHOST=1
and leavingADMIN_ENDPOINT
unset. - Admin Console and admin user data are not accessible via normal user endpoints, including
localhost
andENDPOINT
from the environment. - Admin Console no longer displays audit logs of admin users. However, these logs still exist in the database, and Logto still inserts admin user logs. There is just no convenient interface to inspect them.
- Due to the data isolation, the numbers on the dashboard may slightly decrease (admins are excluded).
- The default Admin Console URL has been changed to
If you are upgrading from a previous version, simply run the database alteration command as usual, and we'll take care of the rest.
Note
DID YOU KNOW
Under the hood, we use the powerful Postgres feature Row-Level Security to isolate admin and user data.
-
1c9160112
: Packages are now ESM. -
343b1090f: 💥 BREAKING CHANGE 💥 Move
/api/phrase
API to/api/.well-known/phrases
-
f41fd3f05
: drop settings table and add systems tableBREAKING CHANGES
- core: removed
GET /settings
andPATCH /settings
API - core: added
GET /configs/admin-console
andPATCH /configs/admin-console
API/configs/*
APIs are config/key-specific now. they may have different logic per key
- cli: change valid
logto db config
keys by removingalterationState
and addingadminConsole
since:- OIDC configs and admin console configs are tenant-level configs (the concept of "tenant" can be ignored until we officially announce it)
- alteration state is still a system-wide config
- core: removed
Minor Changes
-
c12717412
: - mask sensitive password value in audit logs -
f41fd3f05
: Replacepasscode
naming convention in the interaction APIs and main flow ui withverificationCode
. -
c12717412
: ## Creating your social connector with easeWe’re excited to announce that Logto now supports standard protocols (SAML, OIDC, and OAuth2.0) for creating social connectors to integrate external identity providers. Each protocol can create multiple social connectors, giving you more control over your access needs.
To simplify the process of configuring social connectors, we’re replacing code-edit with simple forms. SAML already supports form configuration, with other connectors coming soon. This means you don’t need to compare documents or worry about code format.
-
c12717412
: ## Enable connector methodgetUserInfo
read and write access to DBLogto connectors are designed to be stateless to the extent possible and practical, but it still has some exceptions at times.
With the recent addition of database read and write access, connectors can now store persistent information. For example, connectors can now store access tokens and refresh tokens to minimize number of requests to social vendor's APIs.
-
343b1090f: - Automatically create a new tenant for new cloud users
- Support path-based multi-tenancy
-
343b1090f: Add storage provider: S3Storage
-
343b1090f: Allow admin tenant admin to create tenants without limitation
-
343b1090f: ### Add privacy policy url
In addition to the terms of service url, we also provide a privacy policy url field in the sign-in-experience settings. To better support the end-users' privacy declaration needs.
-
18e3b82e6
: Add user suspend API endpointUse
PATCH /api/users/:userId/is-suspended
to update a user's suspended state, once a user is suspended, all refresh tokens belong to this user will be revoked.Suspended users will get an error toast when trying to sign in.
-
343b1090f: Add API for uploading user images to storage providers: Azure Storage.
-
f41fd3f05
: Officially cleanup all deprecated/session
APIs in core and all the related integration tests. -
343b1090f: Add
sessionNotFoundRedirectUrl
tenant config- User can use this optional config to designate the URL to redirect if session not found in Sign-in Experience.
- Session guard now works for root path as well.
-
343b1090f: New feature: User account settings page
- We have removed the previous settings page and moved it to the account settings page. You can access to the new settings menu by clicking the user avatar in the top right corner.
- You can directly change the language or theme from the popover menu, and explore more account settings by clicking the "Profile" menu item.
- You can update your avatar, name and username in the profile page, and also changing your password.
- [Cloud] Cloud users can also link their email address and social accounts (Google and GitHub at first launch).
-
343b1090f: remove the branding style config and make the logo URL config optional
-
c12717412
: Customize CSS for Sign-in ExperienceWe have put a lot of effort into improving the user sign-in experience and have provided a brand color option for the UI. However, we know that fine-tuning UI requirements can be unpredictable. While Logto is still exploring the best options for customization, we want to provide a programmatic method to unblock your development.
You can now use the Management API
PATCH /api/sign-in-exp
with body{ "customCss": "arbitrary string" }
to set customized CSS for the sign-in experience. You should see the value ofcustomCss
attached after<title>
of the page. If the style has a higher priority, it should be able to override.Note
Since Logto uses CSS Modules, you may see a hash value in the
class
property of DOM elements (e.g. a<div>
withvUugRG_container
). To override these, you can use the$=
CSS selector to match elements that end with a specified value. In this case, it should bediv[class$=container]
. -
2168936b9
: Sign-in Experience v2We are thrilled to announce the release of the newest version of the Sign-in Experience, which includes more ways to sign-in and sign-up, as well as a framework that is easier to understand and more flexible to configure in the Admin Console.
When compared to Sign-in Experience v1, this version’s capability was expanded so that it could support a greater variety of flexible use cases. For example, now users can sign up with email verification code and sign in with email and password.
We hope that this will be able to assist developers in delivering a successful sign-in flow, which will also be appreciated by the end users.
-
1c9160112
: ### Features- Enhanced user search params #2639
- Web hooks
Improvements
- Refactored Interaction APIs and Audit logs
-
f41fd3f05
: - cli: useec
withsecp384r1
as the default key generation type- core: use
ES384
as the signing algorithm for EC keys
- core: use
-
343b1090f: ### Add custom content sign-in-experience settings to allow insert custom static html content to the logto sign-in pages
- feat: combine with the custom css, give the user the ability to further customize the sign-in pages
-
fdb2bb48e
: Streamlining the social sign-up flow- detect trusted email (or phone number) from the social account
- email (or phone number) has been registered: automatically connecting the social identity to the existing user account with a single click
- email (or phone number) not registered: automatically sync up the user profile with the social provided email (or phone) if and only if marked as a required user profile.
- detect trusted email (or phone number) from the social account
-
f41fd3f05
: Replace thesms
naming convention usingphone
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
-
f41fd3f05
: Add support to send and verify verification code in management APIs
Patch Changes
-
e63f5f8b0
: Bump connector kit version to fix "Continue" issues on sending email/sms. -
51f527b0c
: bug fixes- core: fix 500 error when enabling app admin access in console
- ui: handle required profile errors on social binding flow
-
343b1090f: ## Refactor the Admin Console 403 flow
- Add 403 error handler for all AC API requests
- Show confirm modal to notify the user who is not authorized
- Click
confirm
button to sign out and redirect user to the sign-in page
-
343b1090f: Add interactionMode extra OIDC params to specify the desired use interaction experience
- signUp: Deliver a sign-up first interaction experience
- signIn & undefined: Deliver a default sign-in first interaction experience
-
38970fb88
: Fix a Sign-in experience bug that may block some users to sign in. -
343b1090f: Seed data for cloud
- cli!: remove
oidc
option fordatabase seed
command as it's unused - cli: add hidden
--cloud
option fordatabase seed
command to init cloud data - cli, cloud: appending Redirect URIs to Admin Console will deduplicate values before update
- move
UrlSet
andGlobalValues
to@logto/shared
- cli!: remove
-
5e1466f40
: Allow localhost CORS when only one endpoint available -
Updated dependencies [343b1090f]
-
Updated dependencies [
f41fd3f05
] -
Updated dependencies [
e63f5f8b0
] -
Updated dependencies [
f41fd3f05
] -
Updated dependencies [343b1090f]
-
Updated dependencies [343b1090f]
-
Updated dependencies [
c12717412
] -
Updated dependencies [
68f2d56a2
] -
Updated dependencies [343b1090f]
-
Updated dependencies [343b1090f]
-
Updated dependencies [
c12717412
] -
Updated dependencies [343b1090f]
-
Updated dependencies [
38970fb88
] -
Updated dependencies [
c12717412
] -
Updated dependencies [343b1090f]
-
Updated dependencies [343b1090f]
-
Updated dependencies [343b1090f]
-
Updated dependencies [343b1090f]
-
Updated dependencies [
c12717412
] -
Updated dependencies [343b1090f]
-
Updated dependencies [343b1090f]
-
Updated dependencies [
1c9160112
] -
Updated dependencies [343b1090f]
-
Updated dependencies [
1c9160112
] -
Updated dependencies [
f41fd3f05
] -
Updated dependencies [
7fb689b73
] -
Updated dependencies [
1c9160112
] -
Updated dependencies [343b1090f]
-
Updated dependencies [
f41fd3f05
] -
Updated dependencies [
f41fd3f05
] -
Updated dependencies [
2d45cc3e6
] -
Updated dependencies [
3ff2e90cd
]- @logto/schemas@1.0.0
- @logto/shared@1.0.0
- @logto/cli@1.0.0
- @logto/phrases-ui@1.0.0
- @logto/phrases@1.0.0
- @logto/connector-kit@1.1.0
- @logto/core-kit@1.1.0
1.0.0-rc.3
Patch Changes
5e1466f40
: Allow localhost CORS when only one endpoint available- @logto/cli@1.0.0-rc.3
1.0.0-rc.2
Major Changes
-
c12717412
: Decouple users and admins💥 BREAKING CHANGES 💥
Logto was using a single port to serve both normal users and admins, as well as the web console. While we continuously maintain a high level of security, it’ll still be great to decouple these components into two separate parts to keep data isolated and provide a flexible infrastructure.
From this version, Logto now listens to two ports by default, one for normal users (
3001
), and one for admins (3002
).- Nothing changed for normal users. No adaption is needed.
- For admin users:
- The default Admin Console URL has been changed to
http://localhost:3002/console
. - To change the admin port, set the environment variable
ADMIN_PORT
. For instance,ADMIN_PORT=3456
. - You can specify a custom endpoint for admins by setting the environment variable
ADMIN_ENDPOINT
. For example,ADMIN_ENDPOINT=https://admin.your-domain.com
. - You can now completely disable admin endpoints by setting
ADMIN_DISABLE_LOCALHOST=1
and leavingADMIN_ENDPOINT
unset. - Admin Console and admin user data are not accessible via normal user endpoints, including
localhost
andENDPOINT
from the environment. - Admin Console no longer displays audit logs of admin users. However, these logs still exist in the database, and Logto still inserts admin user logs. There is just no convenient interface to inspect them.
- Due to the data isolation, the numbers on the dashboard may slightly decrease (admins are excluded).
- The default Admin Console URL has been changed to
If you are upgrading from a previous version, simply run the database alteration command as usual, and we'll take care of the rest.
Note
DID YOU KNOW
Under the hood, we use the powerful Postgres feature Row-Level Security to isolate admin and user data.
Minor Changes
-
c12717412
: - mask sensitive password value in audit logs -
c12717412
: ## Creating your social connector with easeWe’re excited to announce that Logto now supports standard protocols (SAML, OIDC, and OAuth2.0) for creating social connectors to integrate external identity providers. Each protocol can create multiple social connectors, giving you more control over your access needs.
To simplify the process of configuring social connectors, we’re replacing code-edit with simple forms. SAML already supports form configuration, with other connectors coming soon. This means you don’t need to compare documents or worry about code format.
-
c12717412
: ## Enable connector methodgetUserInfo
read and write access to DBLogto connectors are designed to be stateless to the extent possible and practical, but it still has some exceptions at times.
With the recent addition of database read and write access, connectors can now store persistent information. For example, connectors can now store access tokens and refresh tokens to minimize number of requests to social vendor's APIs.
-
c12717412
: Customize CSS for Sign-in ExperienceWe have put a lot of effort into improving the user sign-in experience and have provided a brand color option for the UI. However, we know that fine-tuning UI requirements can be unpredictable. While Logto is still exploring the best options for customization, we want to provide a programmatic method to unblock your development.
You can now use the Management API
PATCH /api/sign-in-exp
with body{ "customCss": "arbitrary string" }
to set customized CSS for the sign-in experience. You should see the value ofcustomCss
attached after<title>
of the page. If the style has a higher priority, it should be able to override.Note
Since Logto uses CSS Modules, you may see a hash value in the
class
property of DOM elements (e.g. a<div>
withvUugRG_container
). To override these, you can use the$=
CSS selector to match elements that end with a specified value. In this case, it should bediv[class$=container]
.
Patch Changes
- Updated dependencies [
c12717412
] - Updated dependencies [
c12717412
] - Updated dependencies [
c12717412
] - Updated dependencies [
c12717412
]- @logto/phrases@1.0.0-rc.1
- @logto/phrases-ui@1.0.0-rc.1
- @logto/schemas@1.0.0-rc.1
- @logto/cli@1.0.0-rc.2
- @logto/shared@1.0.0-rc.1
1.0.0-rc.1
Patch Changes
-
51f527b0
: bug fixes- core: fix 500 error when enabling app admin access in console
- ui: handle required profile errors on social binding flow
- @logto/cli@1.0.0-rc.1
1.0.0-rc.0
Major Changes
-
f41fd3f0
: drop settings table and add systems tableBREAKING CHANGES
- core: removed
GET /settings
andPATCH /settings
API - core: added
GET /configs/admin-console
andPATCH /configs/admin-console
API/configs/*
APIs are config/key-specific now. they may have different logic per key
- cli: change valid
logto db config
keys by removingalterationState
and addingadminConsole
since:- OIDC configs and admin console configs are tenant-level configs (the concept of "tenant" can be ignored until we officially announce it)
- alteration state is still a system-wide config
- core: removed
Minor Changes
-
f41fd3f0
: Replacepasscode
naming convention in the interaction APIs and main flow ui withverificationCode
. -
f41fd3f0
: Officially cleanup all deprecated/session
APIs in core and all the related integration tests. -
f41fd3f0
: - cli: useec
withsecp384r1
as the default key generation type- core: use
ES384
as the signing algorithm for EC keys
- core: use
-
fdb2bb48
: Streamlining the social sign-up flow- detect trusted email (or phone number) from the social account
- email (or phone number) has been registered: automatically connecting the social identity to the existing user account with a single click
- email (or phone number) not registered: automatically sync up the user profile with the social provided email (or phone) if and only if marked as a required user profile.
- detect trusted email (or phone number) from the social account
-
f41fd3f0
: Replace thesms
naming convention usingphone
cross logto codebase. Including Sign-in Experience types, API paths, API payload and internal variable names. -
f41fd3f0
: Add support to send and verify verification code in management APIs
Patch Changes
- Updated dependencies [
f41fd3f0
] - Updated dependencies [
f41fd3f0
] - Updated dependencies [
f41fd3f0
] - Updated dependencies [
f41fd3f0
] - Updated dependencies [
f41fd3f0
]- @logto/cli@1.0.0-rc.0
- @logto/schemas@1.0.0-rc.0
- @logto/shared@1.0.0-rc.0
1.0.0-beta.19
Patch Changes
- Updated dependencies [
df9e98dc
]- @logto/cli@1.0.0-beta.19
- @logto/schemas@1.0.0-beta.18
- @logto/shared@1.0.0-beta.18
1.0.0-beta.18
Major Changes
1c916011
: Packages are now ESM.
Minor Changes
-
1c916011
: ### Features- Enhanced user search params #2639
- Web hooks
Improvements
- Refactored Interaction APIs and Audit logs
Patch Changes
- Updated dependencies [
1c916011
] - Updated dependencies [
1c916011
] - Updated dependencies [
1c916011
]- @logto/cli@1.0.0-beta.18
- @logto/phrases@1.0.0-beta.17
- @logto/phrases-ui@1.0.0-beta.17
- @logto/schemas@1.0.0-beta.17
- @logto/shared@1.0.0-beta.17
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.- Updated dependencies [
38970fb8
]- @logto/cli@1.0.0-beta.16
- @logto/phrases@1.0.0-beta.16
- @logto/schemas@1.0.0-beta.16
- @logto/shared@1.0.0-beta.16
1.0.0-beta.15
Patch Changes
- Bump connector kit version to fix "Continue" issues on sending email/sms.
- Updated dependencies
- @logto/schemas@1.0.0-beta.15
- @logto/cli@1.0.0-beta.15
- @logto/shared@1.0.0-beta.15
1.0.0-beta.14
Patch Changes
- Updated dependencies [
2d45cc3e
]- @logto/schemas@1.0.0-beta.14
- @logto/cli@1.0.0-beta.14
- @logto/shared@1.0.0-beta.14
1.0.0-beta.13
Minor Changes
-
18e3b82e
: Add user suspend API endpointUse
PATCH /api/users/:userId/is-suspended
to update a user's suspended state, once a user is suspended, all refresh tokens belong to this user will be revoked.Suspended users will get an error toast when trying to sign in.
-
2168936b
: Sign-in Experience v2We are thrilled to announce the release of the newest version of the Sign-in Experience, which includes more ways to sign-in and sign-up, as well as a framework that is easier to understand and more flexible to configure in the Admin Console.
When compared to Sign-in Experience v1, this version’s capability was expanded so that it could support a greater variety of flexible use cases. For example, now users can sign up with email verification code and sign in with email and password.
We hope that this will be able to assist developers in delivering a successful sign-in flow, which will also be appreciated by the end users.
-
40286699
: 💥 Breaking change 💥Use case-insensitive strategy for searching emails
Patch Changes
- Updated dependencies [
68f2d56a
] - Updated dependencies [
3ff2e90c
]- @logto/phrases@1.0.0-beta.13
- @logto/phrases-ui@1.0.0-beta.13
- @logto/cli@1.0.0-beta.13
- @logto/schemas@1.0.0-beta.13
- @logto/shared@1.0.0-beta.13
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/core
1.0.0-beta.11 (2022-10-19)
⚠ BREAKING CHANGES
- update scripts
Features
Bug Fixes
- add redirectURI validation on frontend & backend (#1874) (4b0970b)
- core: fix deletePasscodeByIds bug (#2049) (11b605a)
Miscellaneous Chores
- update scripts (c96495a)
1.0.0-beta.10 (2022-09-28)
⚠ BREAKING CHANGES
- core: update
koaAuth()
to inject detailed auth info (#1977) - core: update user scopes (#1922)
Features
- core,phrases: add check protected access function (e405ef7)
- core,schemas: add phrases schema and GET /custom-phrases/:languageKey route (#1905) (7242aa8)
- core,schemas: migration deploy cli (#1966) (7cc2f4d)
- core,schemas: use timestamp to version migrations (bb4bfd3)
- core: add DELETE /custom-phrases/:languageKey route (#1919) (c72be69)
- core: add GET /custom-phrases route (#1935) (5fe0cf4)
- core: add POST /session/forgot-password/{email,sms}/send-passcode (#1963) (af2600d)
- core: add POST /session/forgot-password/{email,sms}/verify-passcode (#1968) (1ea39f3)
- core: add POST /session/forgot-password/reset (#1972) (acdc86c)
- core: add PUT /custom-phrases/:languageKey route (#1907) (0ae13f0)
- core: add ts to interaction result (#1917) (e01042c)
- core: cannot delete custom phrase used as default language in sign-in exp (#1951) (a1aef26)
- core: check migration state before app start (#1979) (bf1d281)
- core: deploy migration in transaction mode (#1980) (9a89c1a)
- core: machine to machine apps (cd9c697)
- core: save empty string as null value in DB (#1901) (ecdf06e)
- core: support base64 format
OIDC_PRIVATE_KEYS
config in.env
file (#1903) (5bdb675) - core: update migration state after db init (f904b88)
- ui: add passwordless switch (#1976) (ddb0e47)
Bug Fixes
- bump react sdk and essentials toolkit to support CJK characters in idToken (2f92b43)
- core,schemas: move alteration types into schemas src (#2005) (10c1be6)
- core: filter out connector-kit (#1987) (f4cf89f)
- support capital letter "Y" in command line prompt (416f4e8)
Code Refactoring
- core: update
koaAuth()
to inject detailed auth info (#1977) (d4fc7b3) - core: update user scopes (#1922) (8d22b5c)
1.0.0-beta.9 (2022-09-07)
⚠ BREAKING CHANGES
- core: load connectors by folder (#1879)
Features
Bug Fixes
1.0.0-beta.8 (2022-09-01)
Features
1.0.0-beta.6 (2022-08-30)
Features
- core: guard session with sign-in mode (a8a3de3)
1.0.0-beta.5 (2022-08-19)
⚠ BREAKING CHANGES
- core,console: remove
/me
apis (#1781)
Features
- core: enable userinfo endpoint (#1783) (a6bb2f7)
- core: hasura authn (#1790) (87d3a53)
- core: set user default roles from env (#1793) (4afdf3c)
Bug Fixes
- core: fix ac & ui proxy under subpath deployment (#1761) (163c23b)
- deps: update dependency slonik to v30 (#1744) (a9f99db)
Code Refactoring
1.0.0-beta.4 (2022-08-11)
⚠ BREAKING CHANGES
- core: use comma separated values as a string array in the env file (#1762)
Features
- core,schemas: add application secret (#1715) (543ee04)
- core: support signing key rotation (#1732) (00bab4c)
- core: use comma separated values as a string array in the env file (#1762) (f6db981)
Bug Fixes
1.0.0-beta.3 (2022-08-01)
Features
- connector: azure active directory connector added (#1662) (875a828)
- phrases: tr language (#1707) (411a8c2)
1.0.0-beta.2 (2022-07-25)
Features
- core: api GET /me (#1650) (4bf6483)
- core: refresh token rotation reuse interval (#1617) (bb245ad)
- core: support integration test env config (#1619) (708523e)
Bug Fixes
- core: resolve some core no-restricted-syntax lint error (#1606) (c56ddec)
- deps: update dependency koa-router to v12 (#1596) (6e96d73)
1.0.0-beta.1 (2022-07-19)
Features
1.0.0-beta.0 (2022-07-14)
Features
- core: add admin guard to signin (#1523) (3e76de0)
- core: read connector packages env (#1478) (adadcbe)
Bug Fixes
- connector: fix connector getConfig and validateConfig type (#1530) (88a54aa)
- connector: passwordless connector send test msg with unsaved config (#1539) (0297f6c)
- connector: refactor ConnectorInstance as class (#1541) (6b9ad58)
- ui,core: fix i18n issue (#1548) (6b58d8a)
1.0.0-alpha.4 (2022-07-08)
Features
- connector: connector error handler, throw errmsg on general errors (#1458) (7da1de3)
- expose zod error (#1474) (81b63f0)
Bug Fixes
1.0.0-alpha.3 (2022-07-07)
Features
Bug Fixes
- core,ui: remove todo comments (#1454) (d5d6c5e)
- deps: update dependency koa-router to v11 (#1406) (ff6f223)
1.0.0-alpha.2 (2022-07-07)
Note: Version bump only for package @logto/core
1.0.0-alpha.1 (2022-07-05)
Bug Fixes
1.0.0-alpha.0 (2022-07-04)
Note: Version bump only for package @logto/core
0.1.2-alpha.5 (2022-07-03)
Note: Version bump only for package @logto/core
0.1.2-alpha.4 (2022-07-03)
Note: Version bump only for package @logto/core
0.1.2-alpha.3 (2022-07-03)
Features
0.1.2-alpha.2 (2022-07-02)
Note: Version bump only for package @logto/core
0.1.2-alpha.1 (2022-07-02)
Note: Version bump only for package @logto/core
0.1.2-alpha.0 (2022-07-02)
Note: Version bump only for package @logto/core
0.1.1-alpha.0 (2022-07-01)
Features
- ac: implement admin console welcome page (#1139) (b42f4ba)
- connector-alipay-native: add Alipay Native connector (#873) (9589aea)
- connector-sendgrid-email: add sendgrid email connector (#850) (b887655)
- connector-twilio-sms: add twilio sms connector (#881) (d7ce13d)
- connector: apple (#966) (7400ed8)
- connectors: handle authorization callback parameters in each connector respectively (#1166) (097aade)
- console,core: hide admin user (#1182) (9194a6e)
- console: add column lastSignIn in user management (#679) (a0b4b98)
- console: dark logo (#860) (664a218)
- console: sie form reorg (#1218) (2c41334)
- console: support persisting get-started progress in settings config (43b2309)
- core,connectors: update Aliyun logo and add logo_dark to Apple, Github (#1194) (98f8083)
- core,console: change admin user password (#1268) (a4d0a94)
- core,console: connector platform tabs (#887) (65fb36c)
- core,console: social connector targets (#851) (127664a)
- core,schemas: koaLogSession middleware (#767) (4e60446)
- core,schemas: log IP and user agent (#682) (0ecb7e4)
- core,schemas: log token exchange success (#809) (3b048a8)
- core,schemas: save application id that the user first consented (#688) (4521c3c)
- core,shared: get /dashboard/users/active (#953) (1420bb2)
- core: add admin role validation to the koaAuth (#920) (cf360b9)
- core: add custom claims to id token (#911) (9ccda93)
- core: add etag for settings api (#1011) (d4f38bc)
- core: add phone number and email mask (#891) (67f080e)
- core: add role table seed (#1145) (837ad52)
- core: add sign-in-mode (#1132) (f640dad)
- core: add smtp connector (#1131) (f8710e1)
- core: add socialConnectors details for get sign-in-settings (#804) (7a922cb)
- core: add switch of enabling object fully replace when updating DB (#1107) (efa9491)
- core: add welcome route (#1080) (f6f562a)
- core: align connector error handler middleware with ConnectorErrorCodes (#1063) (1b8190a)
- core: any-type parameter shows empty object in swagger example (#1110) (7339a85)
- core: append page and page_size to the query parameters in swagger.json (#1120) (a262999)
- core: convert route guards to swagger.json (#1047) (3145c9b)
- core: convert Zod union, literal and string guards to OpenAPI schemas (#1126) (511012d)
- core: cookie keys configuration (#902) (17c63cd)
- core: dau curve contains 0 count points (#1105) (75ac874)
- core: disable introspection feature (#886) (b2ac2c1)
- core: empty path sould redirect to the console page (#915) (207c404)
- core: expose connector and metadata from sendPasscode (#806) (0ea5513)
- core: fix connectors' initialization (c6f2546)
- core: get /dashboard/users/new (#940) (45a9777)
- core: get /dashboard/users/total (#936) (c4bb0de)
- core: get /logs (#823) (4ffd4c0)
- core: get /logs/:id (#934) (bddf47b)
- core: grantErrorListener for logging token exchange error (#894) (797344f)
- core: grantRevokedListener for logging revocation of access and refresh token (#900) (e5196fc)
- core: identities key should use target not connectorId (#1115) (41e37a7), closes #1134
- core: log error body (#1065) (2ba1121)
- core: log sending passcode with connector id (#824) (82c7138)
- core: make GET /api/swagger.json contain all api routes (#1008) (8af2f95)
- core: order logs by created_at desc (#993) (2ae4e2e)
- core: register with admin role (#1140) (4f32ad3)
- core: remove code redundancy (d989785)
- core: remove unnecessary variable check and unused route (#1084) (bcc05e5)
- core: separate social sign-in api (#735) (e71cf7e)
- core: serve connector logo (#931) (5b44b71)
- core: set claims for
profile
scope (#1013) (7781d49) - core: update connector db schema (#732) (8e1533a)
- demo-app: implementation (#982) (7f4f4f8)
- demo-app: implementation (3/3) (#1021) (91e2f05)
- native-connectors: pass random state to native connector sdk (#922) (9679620)
- remove target, platform from connector schema and add id to metadata (#930) (054b0f7)
- update field check rules (#854) (85a407c)
- use user level custom data to save preferences (#1045) (f2b44b4)
Bug Fixes
lint:report
script (#730) (3b17324)- connector-wechat-native: fix wechat-native target (#820) (ab6c124)
- connectors platform (#925) (16ec018)
- console,core: only show enabled connectors in sign in methods (#988) (4768181)
- console: update terms of use (#1122) (9262a6f)
- console: update user data (#1184) (a3d3a79)
- core,console: delete specific user identities by target (#1176) (ad86bc8)
- core: align jsonb replace mode (#1138) (3cf34b5)
- core: allow empty condition in logs (#991) (2819859)
- core: catch interaction not found error (#827) (38ceae7)
- core: disabled session check for preview mode (#867) (82674ee)
- core: fix connector readme and configTemplate content parsing (#1267) (05db124)
- core: fix preview session not found bug (#970) (545a392)
- core: koaAuth should return 403 instead of 401 on non-admin role (ee16eeb)
- core: prevent session lost for bind social (#948) (077ed12)
- core: remove ESM declaration (#687) (e61dba9)
- core: remove name regex (#1109) (a790248)
- core: remove unavailable social sign in targets on save (#1201) (012562e)
- core: revert add custom claims to id token (#919) (fe99928)
- core: set module in base config (#685) (d108f4b)
- core: settings api should not throw session not found error (#1157) (e0793fa)
- core: signing in with a non-existing username should throw invalid credentials (#1239) (53781d6)
- core: social user info in session (#794) (74f2940)
- core: update proxy guard middleware (#963) (909535f)
- core: update role names (#913) (d659995)
- core: update roleNames to role_names to resolve 401 errors (5a1fa14)
- core: update timestamp field with millisecond precision (#677) (7278ba4)
- delete custom domain (#737) (8a48fb6)
- ui: fix sign-in not found bug (#841) (5d34442)