Changelog

Table of Contents

(2024-04-26)
- Breaking Changes
  - Bug Fixes
  - Features
  - Tests
  - Unclassified
1.1.0 (2024-02-20)
- Breaking Changes
1.0.0 (2023-07-12)
- Bug Fixes
- Code Generation
- Documentation
- Features
- Tests
- Unclassified
0.13.0 (2023-04-18)
- Breaking Changes
0.11.1 (2023-01-14)
- Breaking Changes
0.11.0 (2022-12-02)
- Code Generation
- Features
0.11.0-alpha.0.pre.2 (2022-11-28)
- Breaking Changes
0.10.1 (2022-06-01)
- Bug Fixes
- Code Generation
0.10.0 (2022-05-30)
- Breaking Changes
0.9.0-alpha.3 (2022-03-25)
- Breaking Changes
0.9.0-alpha.2 (2022-03-22)
- Bug Fixes
- Code Generation
0.9.0-alpha.1 (2022-03-21)
- Breaking Changes
0.8.3-alpha.1.pre.0 (2022-01-21)
- Breaking Changes
0.8.2-alpha.1 (2021-12-17)
- Bug Fixes
- Code Generation
- Documentation
0.8.1-alpha.1 (2021-12-13)
- Bug Fixes
- Code Generation
- Documentation
- Features
- Tests
0.8.0-alpha.4.pre.0 (2021-11-09)
- Breaking Changes
0.8.0-alpha.3 (2021-10-28)
- Bug Fixes
- Code Generation
0.8.0-alpha.2 (2021-10-28)
- Code Generation
0.8.0-alpha.1 (2021-10-27)
- Breaking Changes
0.7.6-alpha.1 (2021-09-12)
- Code Generation
0.7.5-alpha.1 (2021-09-11)
- Code Generation
0.7.4-alpha.1 (2021-09-09)
- Bug Fixes
- Code Generation
- Documentation
- Features
- Tests
0.7.3-alpha.1 (2021-08-28)
- Bug Fixes
- Code Generation
- Documentation
- Features
0.7.1-alpha.1 (2021-07-22)
- Bug Fixes
- Code Generation
- Documentation
- Tests
0.7.0-alpha.1 (2021-07-13)
- Breaking Changes
0.6.3-alpha.1 (2021-05-17)
- Breaking Changes
0.6.2-alpha.1 (2021-05-14)
- Code Generation
- Documentation
0.6.1-alpha.1 (2021-05-11)
- Code Generation
- Features
0.6.0-alpha.2 (2021-05-07)
- Bug Fixes
- Code Generation
- Features
0.6.0-alpha.1 (2021-05-05)
- Breaking Changes
0.5.5-alpha.1 (2020-12-09)
- Bug Fixes
- Code Generation
- Documentation
- Features
- Tests
- Unclassified
0.5.4-alpha.1 (2020-11-11)
- Bug Fixes
- Code Generation
- Code Refactoring
- Documentation
- Features
0.5.3-alpha.1 (2020-10-27)
- Bug Fixes
- Code Generation
- Documentation
- Features
- Tests
0.5.2-alpha.1 (2020-10-22)
- Bug Fixes
- Code Generation
- Documentation
- Tests
0.5.1-alpha.1 (2020-10-20)
- Bug Fixes
- Code Generation
- Documentation
- Features
- Tests
- Unclassified
0.5.0-alpha.1 (2020-10-15)
- Breaking Changes
0.4.6-alpha.1 (2020-07-13)
- Bug Fixes
- Code Generation
0.4.5-alpha.1 (2020-07-13)
- Bug Fixes
- Code Generation
0.4.4-alpha.1 (2020-07-10)
- Bug Fixes
- Code Generation
- Documentation
0.4.3-alpha.1 (2020-07-08)
- Bug Fixes
- Code Generation
0.4.2-alpha.1 (2020-07-08)
- Bug Fixes
- Code Generation
0.4.0-alpha.1 (2020-07-08)
- Breaking Changes
0.3.0-alpha.1 (2020-05-15)
- Breaking Changes
0.2.1-alpha.1 (2020-05-05)
- Chores
- Documentation
0.2.0-alpha.2 (2020-05-04)
- Breaking Changes
0.1.1-alpha.1 (2020-02-18)
- Bug Fixes
- Code Refactoring
- Documentation
0.1.0-alpha.6 (2020-02-16)
- Bug Fixes
- Code Refactoring
- Documentation
- Features
0.1.0-alpha.5 (2020-02-06)
- Documentation
- Features
0.1.0-alpha.4 (2020-02-06)
- Continuous Integration
- Documentation
0.1.0-alpha.3 (2020-02-06)
- Continuous Integration
0.1.0-alpha.2 (2020-02-03)
- Bug Fixes
- Documentation
- Features
- Unclassified
0.1.0-alpha.1 (2020-01-31)
- Documentation
0.0.3-alpha.15 (2020-01-31)
- Unclassified
0.0.3-alpha.14 (2020-01-31)
- Unclassified
0.0.3-alpha.13 (2020-01-31)
- Unclassified
0.0.3-alpha.11 (2020-01-31)
- Unclassified
0.0.3-alpha.10 (2020-01-31)
- Unclassified
0.0.3-alpha.7 (2020-01-30)
- Unclassified
0.0.3-alpha.5 (2020-01-30)
- Continuous Integration
- Unclassified
0.0.3-alpha.4 (2020-01-30)
- Unclassified
0.0.3-alpha.2 (2020-01-30)
- Unclassified
0.0.3-alpha.1 (2020-01-30)
- Unclassified
0.0.1-alpha.9 (2020-01-29)
- Continuous Integration
0.0.2-alpha.1 (2020-01-29)
- Unclassified
0.0.1-alpha.6 (2020-01-29)
- Continuous Integration
0.0.1-alpha.5 (2020-01-29)
- Continuous Integration
- Unclassified
0.0.1-alpha.3 (2020-01-28)
- Continuous Integration
- Documentation
- Unclassified

(2024-04-26)

Breaking Changes

This feature enables two-step registration per default. Two-step registration is a significantly improved sign up flow and recommended when using more than one sign up methods. To disable two-step registration, set selfservice.flows.registration.enable_legacy_flow to true. This value defaults to false.

Bug Fixes

Add login succeeded event to post registration hook (#3739) (b685fa5)
Add missing env vars to set up guide (#3855) (da90502):

Closes ory#3828
Add missing indexes and remove unused index (6d7372e)
Add missing indexes and remove unused index (#3756) (c905f02)
Add sms mfa via parameter to spec (#3766) (b291c95)
Allow updating just the verified_at timestamp of addresses (#3880) (696cc1b)
Always issue session last (#3876) (e942507):

In post persist hooks, the session issuance hook always needs to come last. This fixes the getHooks function to ensure this.
Audit issues (#3797) (7017490)
Close res body (#3870) (cc39f8d)
Db index and duplicate credentials error (#3896) (9f34a21):
- fix: don't return password cred type if empty
- fix: better index for config.user_handle on identity_credentials
Do not require method to be passkey in settings schema (#3862) (660f330)
Don't require connection_uri in SMTP (#3861) (800f8f1)
Don't treat passkeys as AAL2 (#3853) (8eee972)
Drop index if exists (#3846) (ad0619d)
Drop trigram index on identifiers (#3827) (8f8fd90)
Enum type of session expandables (#3891) (63d785e)
Enum type of session expandables (#3895) (c435727)
Execute verification & verification_ui properly in login flows (#3847) (5aad1c1)
Ignore decrypt errors in WithDeclassifiedCredentials (#3731) (8f5192f)
Improve SDK discriminators (#3844) (c08b3ad)
Include all creds in duplicate credential err (#3881) (e06c241)
Linkedin issuer override (#3875) (11d221a)
Make sure emails can still be sent with SMS enabled (#3795) (7c68c5a)
Missing indices and foreign keys (#3800) (0b32ce1)
Passing transient payloads (#3838) (d01b670)
Prevent SMTP URL leak on unparsable URL (#3770) (c5f39f4)
Respect return_to in OIDC API flow error case (#3893) (e8f1bcb):
- fix: respect return_to in OIDC API flow error case
This fix ensures that we redirect the user to the return_to URL when an error occurs during the OIDC login for native flows.

Native flows are initialized through the API, and the browser URL is retrieved from a 422 response after a POST to submit the login flow. Successful OIDC flows already returned the code to the return_to URL. Now, unsuccessful flows return the flow with the current flow ID (which might have changed), so that the caller can retrieve the full flow and act accordingly.
- fix: ignore trivvy CVE report
Bump in distroless is still open
sdk: Expand identity in session extension (#3843) (04f0231), closes #3842
sdk: Improve discriminators for node and Go (#3821) (9ddf7cc)
Show error page on identity mismatch (#3790) (e6db689)
Test assertions on declassifying OIDC tokens (#3773) (7f8a7f1)
Tolerate more "truthy" values when creating new flows (#3841) (49d93c0), closes #3839:

Use strconv.ParseBool to accept multiple "truthy" values for the refresh and return_session_token_exchange_code query parameters when creating a new login flow.

For some SDKs (e.g.: Python), these stringification of booleans is not user-controlled and these endpoints could not be used fully due to the backend ignoring any value other than true (all lowercase).
Tweaks to UpsertSessions (#3878) (da51dcd)
Use correct post-verification identity state in post-hooks (#3863) (6e63d06)
Webhook transient payload in OIDC login flows (#3857) (2cdfc70):
- fix: transient payload with OIDC login

Features

Add include_credential query param to /admin/identities list call (#3343) (d94530a)
Add headers to web hooks (#3849) (4642de0)
Add session to post login webhook (#3877) (386078e)
Add transient payloads to all flows (#3738) (b8b747b)
Add twitter SSO (#3778) (930fb19)
Add verification hook to login flow (#3829) (43e4ead)
Control edge cache ttl (#3808) (c9dcce5)
Linkedin v2 provider (#3804) (a6ad983):
- feat: add linkedin-v2 provider
- docs: document linkedin special-case
PassKeys with Resident Keys and two-step registration (#3748) (3621411)
Send OIDC claim keys to tracing (#3798) (04390be)
Use authenticate endpoint for x (#3833) (3d9ba5d):

Improves the "Log in with X" experience by not asking the user to re-authenticate every time.

Tests

Deflake session test (#3864) (6b275f3)
Resolve failing test for empty tokens (#3775) (7277368)

Unclassified

Remove unnecessary COPY command from Dockerfile (#3771) (087748c), closes #3771

1.1.0 (2024-02-20)

Ory Kratos v1.1 is the most complete, most scalable, and most secure open-source identity server on the planet, and we are thrilled to announce its release! This release comes with over 270 commits and an incredible amount of new features and capabilities!

Phone Verification & 2FA with SMS: Enhance convenient security with phone verification and two-factor authentication (2FA) via SMS, integrating easily with SMS gateways like Twilio. This feature not only adds a convenient layer of security but also offers a straightforward method for user verification, increasing your trust in user accounts.
Translations & Internationalization: Ory Kratos now supports multiple languages, making it accessible to a global audience. This improvement enhances the user experience by providing a localized interface, ensuring users interact with the system in their preferred language.
Native Support for Sign in with Google and Apple on Android/iOS: Get more sign-ups with native support for "Sign in with Google" and "Sign in with Apple" on mobile platforms. Great user experience matters!
Account Linking: Simplify user management with new features that facilitate account linking. If a user registers with a password and later signs in with a social account sharing the same email, new screens make account linking straightforward, enhancing user convenience and reducing support inquiries.
Passwordless "Magic Code": Introduce a passwordless login method with "Magic Code," which sends a one-time code to the user's email for sign-up and login. This method can also serve as a fallback when users forget their password or their social login is unavailable, streamlining the login process and improving user accessibility.
Session to JWT Conversion: Convert an Ory Session Cookie or Ory Session Token into a JSON Web Token (JWT), providing more flexibility in handling sessions and integrating with other systems. This feature allows for seamless authentication and authorization processes across different platforms and services.

Note: To ensure a seamless upgrade experience with minimal impact, some of these features are gated behind the feature_flags config parameter, allowing controlled deployment and testing.

The following features have been shipped exclusively to Ory Network for this version:

B2B SSO allows your customers to connect their LDAP / Okta / AD / … to your login. Ory selects the correct login provider based on the user’s email domain.
**Significantly better API performance** for expensive API operations by specifying the desired consistency (strong, eventual).
Finding users effortlessly with our new fuzzy search for credential identifiers available for the Identity List API.
Better reliability when sending out emails across different providers.
Streamlining the HTTP API and improving related SDK methods.
Better performance when calling the whoami API endpoint, updating identities, and listing identities.
The performance of listing identities has significantly improved with the introduction of keyset pagination. Page pagination is still available but will be fully deprecated soon.
Ability to list multiple identities in a batch call.
Passkeys and WebAuthn now support multiple origins, useful when working with subdomains.
The logout flow now redirects the user back to the return_to parameter set in the API call.
When updating their settings, the user was sometimes incorrectly asked to confirm the changes by providing their password. This issue has now been fixed.
When signing up with an account that already exists, the user will be shown a hint helping them sign in to their existing account.
CORS configuration can now be hot-reloaded.
The integration with Ory OAuth2 / Ory Hydra has improved for logout, login session management, verification, and recovery flows.
A new passwordless method has been added: "Magic code". It sends a one-time code to the user's email during sign-up and log-in. This method can additionally be used as a fallback login method when the user forgets their password.
Integration with social sign-in has improved, and it is now possible to use the email verified status from the social sign-in provider.
Ory Elements and the default Ory Account Experience are now internationalized with translations.
It is now possible to convert an Ory Session Cookie or Ory Session Token into a JSON Web Token.
Recovery on native apps has improved significantly and no longer requires the user to switch to a browser for the recovery step.
Administrators can now find users by their identifiers with fuzzy search - this feature is still in preview.
Importing HMAC-hashed passwords is now possible.
Webhooks can now update identity admin metadata.
New screens have been added to make account linking possible when a user has registered with a password and later tries signing in with a social account sharing the same email.
Ability to revoke all sessions of a user when they change their password.
Webhooks are now available for all login, registration, and login methods, including Passkeys, TOTP, and others.
The login screen now longer shows “ID” for the primary identifier, but instead extracts the correct label - for example, “Email” or “Username” from the Identity Schema.
Login hints help users with guidance when they are unable to sign in (wrong social sign-in provider) but have an active account.
Phone numbers can now be verified via an SMS gateway like Twilio.
SMS OTP is now a two-factor option. Ory Kratos 1.1 is a major release that marks a significant milestone in our journey.

We sincerely hope that you find these new features and improvements in Ory Kratos 1.1 valuable for your projects. To experience the power of the latest release, we encourage you to get the latest version of Ory Kratos here or leverage Ory Kratos in Ory Network — the easiest, simplest, and most cost-effective way to run Ory.

For organizations seeking to upgrade their self-hosted solution, Ory offers enterprise support services to ensure a smooth transition. Our team is ready to assist you throughout the migration process, ensuring uninterrupted access to the latest features and improvements. Additionally, we provide various support plans specifically tailored for self-hosting organizations. These plans offer comprehensive assistance and guidance to optimize your Ory deployments and meet your unique requirements. We extend our heartfelt gratitude to the vibrant and supportive Ory Community. Without your constant support, feedback, and contributions, reaching this significant milestone would not have been possible. As we continue on this journey, your feedback and suggestions are invaluable to us. Together, we are shaping the future of identity management and authentication in the digital landscape.

Contributors to this release in no particular order: moose115, K3das, sidartha, efesler, BrandonNoad ,Saancreed, jpogorzelski, dreksx, martinloesethjensen, cpoyatos1, misamu, tristankenney, nxy7, anhnmt

Are you passionate about security and want to make a meaningful impact in one of the biggest open-source communities? Join the Ory community and become a part of the new ID stack. Together, we are building the next generation of IAM solutions that empower organizations and individuals to secure their identities effectively. Want to check out Ory Kratos yourself? Use these commands to get your Ory Kratos project running on the Ory Network:

brew install ory/tap/cli

scoop bucket add ory <https://github.com/ory/scoop.git>
scoop install ory

bash <(curl <https://raw.githubusercontent.com/ory/meta/master/install.sh>) -b . ory
sudo mv ./ory /usr/local/bin/

ory auth login

ory create project --name "My first Kratos project"

ory open account-experience registration

ory patch identity-config \
  --replace '/identity/default_schema_id="preset://username"' \
  --replace '/identity/schemas=[{"id":"preset://username","url":"preset://username"}]' \
  --format yaml

ory open account-experience registration

Breaking Changes

Pagination parameters for the list identities CLI command have changed from arguments to flags --page-token and page-size:

- kratos list identities 1 100
+ kratos list identities --page-size 100 --page-token ...

Furthermore, the JSON / JSON pretty output of list identities has changed:

-[
-  { "id": "..." },
-  { /* ... */ },
-  // ...
-]
+{
+  "identities": [
+    {"id": "..."},
+    { /* ... */ },
+    // ...
+  ],
+  "next_page_token": "..."
+}

Closes ory/sdk#284 Closes ory#3480

Bug Fixes

oidc does not require a method in the payload (#3564) (b299abc):
- fix: oidc does not require a method in the payload
- refactor: only update strategies order in test
- chore: update audit messages and comments
Accept all 200 responses as OK in courier (#3401) (88237e2), closes #3399:
- fix: accept all 200 responses as OK in courier
Accept login_challenge after verification (#3427) (6b02350):

Part of ory/network#320
Add caching to Jsonnet snippet during session JWT tokenization (#3699) (1da8180)
Add consistency flag (#3733) (fd79950)
Add max-age to default cors headers (#3584) (c5b4aaa)
Add missing tracing & attributes in oidc strategy (#3429) (09bcb71)
Add return_to parameter to API spec of createRecoveryLinkForIdentity (#3711) (757a5e4)
Add value code to authentication method enum (#3546) (95dc7a2):
- fix: add value code to authentication method enum
- chore: generate sdk
Additional_id_token_audiences key in config schema (#3622) (9396bb0)
Adjust tracing verbosity (976cd0d)
Allow post recovery hooks to interrupt the flow (#3393) (6c1d2f1)
Allow updating admin metadata from webhook responses (#3569) (22f61f0)
Always return relative URLs in the Link header for pagination (fb229c9)
Auto migrate old accounts to use code credential (#3581) (569b14a)
Carry oauth2_login_challenge over to registration flow (#3419) (76241be):

Fixes ory#3321
Change ListIdentities to keyset pagination (e16fed1)
Change shebangs and makefile from /bin/bash to /usr/bin/env bash (#3597) (1343bbb):
- makefile fix
- shebangs changed to /usr/bin/env bash
Signed-off-by: nxy7 lolnoxy@gmail.com
Check whoami aal before accepting hydra login request (#3669) (a2f79c3)
Code method on registration and 2fa (#3481) (7aa2e29)
Consider OIDC registration flows errored with duplicate credential to be completed by strategy (#3525) (3e3c789):

Returning anything else here may cause Kratos to respond with two concatenated JSON objects: new login flow with actual error message as the first one and a very confusing '500, aborted registration hook execution' as the second one.
Csrf token regenerate on browser flows (#3706) (e4908db), closes #3705
Data race in test (ab6dc31)
Do not encode full config in multiple places (#3500) (57a3273)
Do not generate CSRF token for api flows (#3704) (d93570d)
Do not initialize parts of the registry in parallel (#3534) (ff177db)
Don't list org SSOs in settings (#3637) (6c7068c)
Don't require code credential for MFA flows (#3753) (40ed809)
Don't require session for OIDC verification (#3443) (e08f831)
Don't return 500 on conflict for POST /admin/identities (#3437) (1429949)
Don't return nil if code is invalid (#3662) (df8ec2b):
- fix: don't return nil if code is invalid
- chore: add test
Error handling on identity import (#3520) (83bfb2d):

When importing identities without any traits, or with malformed traits, 500s are returned. This improves the error handling and messaging.
False-positives for requiring re-authentication on update (#3421) (ce8139f)
Http courier using should use lower case json (#3740) (84149c4)
Identity list pagination in CLI command and SDK (#3482) (1e8b1ae):

Adds correct pagination parameters to the SDK methods for listing identities and sessions.
Ignore CSRF middleware on Apple OIDC callback (309c506)
Ignore more cloudflare cookies (#3499) (f124ab5)
Improved SSRF protection (#3629) (6d08576):

This also improves tracing in the OIDC strategy.
Incorrect login accept challenge (#3658) (b5dede3)
Incorrect sdk generator path (#3488) (ed996c0)
Incorrect SMTP error handling (#3636) (ee138ec)
Incorrect swagger spec for filter parameter (#3684) (2c1470a), closes #3676 #3675
Increase connection-level timeouts and shutdown timeouts (#3570) (200b413):

The admin API is generally expected to require longer timeouts, for example during bulk identity import.
Issue session after verification after registration with OIDC SSO (#3467) (a28b523)
Lint (e8740c3)
Lower-case recovery & verification emails on import (#3571) (e2ac9ff):

Emails that contained upper-case characters would be overwritten by the identity schema extension runner, because there all emails are lower-cased.
Mark identity as optional in session struct (#3463) (7ae02ba), closes #3461:

The identity is not always available in the session struct, for example when AAL2 is required.
Omit irrelevant OIDC providers in forced refresh login flows (#3608) (912dccd):

Whenever an user is asked to reauthenticate (e.g. because they wish to execute settings flow touching their credentials and their session is no longer privileged) they are asked to provide their credentials again. The forced-refresh login flow generated for such cases already excludes some strategies that are enabled in Kratos but cannot be used to authenticate as current identity, and for example the form presented to the user will not have a password field if the identity does not have a password credential.

This, however, does not currently apply to OIDC providers; the user will always see the full set even if some of them can't be used to sign in as current identity. This change causes forced refresh login flows to also omit irrelevant OIDC providers in generated form in order to avoid confunding the user about which strategies/providers are valid and can actually be used to reauthenticate.
On verification required after registration, preserve return_to (#3589) (6a0a914):
- fix: on verification required after registration, preserve return_to
- test: return_to on verification flow
- chore: refactor
Panic in recovery (#3639) (c25ddff)
Pass context (#3452) (c492bdc)
Properly normalize OIDC verified emails (#3450) (703b910)
Redirect to verification URL even if login_challenge is set (#3412) (cd9e6a0):

Fixes ory/network#320
Reduce db lookups in whoami for aal check (#3372) (d814a48):

Significantly improves performance by reducing the amount of queries we need to do when checking for the different AAL levels.
Registration code ui nodes group (#3505) (6220184):
- fix: registration code ui nodes group
- style: format
Registration should accept hydra login (#3592) (7a47827):
- fix: registration should accept hydra login
- fix: oauth2 registration flow with session
- wip: registration oauth flow tests
- wip: refactor oauth flows test
- wip: refactor op_registration_test
- wip: oauth provider registration test
- wip: refactor oauth flows test
- fix(test): oauth provider login
- style: format
Registration with verification (#3451) (77c3196)
Reject obviously invalid email addresses from courier (8cb9e4c)
Remove earliest_possible_extend default in schema (#3464) (7e05b7d)
Remove duplicate message ID usage (#3468) (dfcbe22)
Remove requirement for smtp section (#3405) (59a3f14)
Remove slow queries from update identities (#3553) (d138abb)
Rename "phone" courier channel to "sms" (#3680) (eb8d1b9)
Respect gomail.SendError in mail queue (#3600) (9c608b9)
Respond with 422 when SPA identity requires AAL2 (#3572) (df18c09):

If you submit a browser login flow with an Accept header of application/json, but the login flow requires AAL2, then there is no way for the code to know it needs to redirect the user to the 2FA page. Instead of responding with the Session in this scenario, this PR changes the behaviour to respond with a browser_location_change_required error (status 422) to indicate that the browser needs to open a specific URL, /self-service/login/browser?aal=aal2.
Return 400 bad request for invalid login challenge (#3404) (ca34e9b)
Return HTTP 400 if key unmarshal fails (#3594) (fdf4956):
- fix: return HTTP 400 if key unmarshal fails
- fix: apply reviewer's suggestion, prepare for bump
- fix: follow up reviewer suggestion from ory/x
- chore: bump ory/x
Schema test errors (#3528) (bee0341)
Set iss from userinfo claims if missing (#3744) (241a911)
Specify correct minimum versions in migratest (18b89ea)
Tracing context passing in /sessions/whoami (1254bf5)
Tracing improvements (c804cb2)
Type-assert all interfaces that WebHook implements (ffda1a0)
Ui node input attributes key added (#3561) (9eff0f3):
- fix: ui node InputAttributes.Key added
- fix: selfservice recovery flow add React unique key and numeric pattern
- fix: remove React related key addition
- test: update snapshot
Use ID label on login with multiple identifiers (#3657) (be907db)
Use org ID from session if available in login flow (#3545) (1b3647c)
Use provider label in link message (#3661) (fa5ec93)
Use registry client for schema loading (#3471) (3a57726)
Using first name as last name (#3556) (df80377)
Wrong continue_with enum declaration (#3522) (4c34c24)

Code Generation

Pin v1.1.0 release commit (f47675b)

Documentation

Add example for allowed_return_urls to include wildcard url (#3533) (39b0c3c), closes #1528
Improve enum handling and completeness (#3714) (4b881ca)
Remove experimental warnings (#3406) (d4d26e6):

See ory#3388
Update link to hashed password formats (#3484) (8ca3adc)

Features

Add ability to convert session to JWT when calling whoami (#3472) (57b7bb8), closes #2487:

This patch adds a query parameter tokenize_as to /session/whoami which encodes the session to a JWT. It is possible to customize the JWT claims by using a JsonNet template, and furthermore change the expiry of the token.

The tokenize feature supports multiple templates, which makes it easy to use the resulting JWT in a variety of use cases.
Add event (#3524) (75031e6)
Add GetID member functions to RecoveryAddress and Credentials (#3474) (085d500)
Add ID Token sign in with Google Android/iOS SDK (#3515) (055ed92)
Add OpenTelemetry span for password hash comparison (#3383) (e3fcf0c)
Add request URL to email and SMS templates (bf5f8c3)
Add sms verification for phone numbers (#3649) (e3a3c4f)
Add support for recovery on native flows (#3273) (e363889)
Add WebhookSucceeded event (aa8c936)
Added various new text messages (ea91483):

To improve i18n and message customization, we added a bunch of new messages. Integrations that do message customization should probably handle those new message codes:
- 1010014
- 1010015
- 1040005
- 1040006
- 1070012
- 1070013
- 4000028
- 4000029
- 4000030
- 4000031
- 4000032
- 4000033
- 4000034
- 4000035
- 4000036
- 4010007
- 4010008
- 4040002
- 4040003
Additionally, these messages got more context:
- 1050014
- 1050018
- 1070002
- 4000001
- 4000003
- 4000004
- 4000017
- 4000018
- 4000019
- 4000020
- 4000021
- 4000022
- 4000023
- 4000024
- 4000025
- 4000026
- 4010001
- 4040001
- 4050001
- 4060005
- 4070005
- 5000001
Allow additional id token audiences (#3616) (0fa648d)
Allow extra migrations in NewPersister (96c1ff7)
Allow fuzzy-search on credential identifiers (#3526) (2cb3ea2):

This PR adds the ability to search for sub-strings and similar strings in credential identifiers.

Note that the postgres and CRDB migrations create special indexes useful for this feature. To use online schema changes with cockroach, we recommend to manually copy the index definition and run it before applying migrations. The migration will then be a no-op.

If you run on mysql (or sqlite), no special index is created. If desired, you can create such an index manually, and it would be highly appreciated if you could contribute its definition.

This feature is a preview and will change in behavior! Similarity search is not expected to return deterministic results but are useful for humans.
Allow importing hmac hashed passwords (#3544) (0a0e1f7), closes #2422:

The basic format is $hmac-<hashfunction>$<base64 encoded hash>$<base64 encoded key>:
```
# password = test; key=key; hash function=sha
$hmac-sha1$NjcxZjU0Y2UwYzU0MGY3OGZmZTFlMjZkY2Y5YzJhMDQ3YWVhNGZkYQ==$a2V5
```
Allow marking OIDC provider-verified addresses as verified during registration (#3448) (e7b33a1), closes #3445 #3424 #1057:

This feature allows marking emails provided by social sign in providers as verified.
Batch list identities (#3598) (8ad54f1), closes #2448:

This change allows to filter GET /admin/identities by ID with the following syntax:
```
/admin/identities?ids=id1&ids=id2&ids=id3
```
changelog: Add support for native recovery (#3624) (492808c):

Adds the ability to complete the recovery flow properly on API flows. This PR also streamlines the behavior for SPA flows to not return 422 errors anymore. To enable this new behavior, set the features.use_continue_with_transitions flag in the config to true.

See also ory#3273
Claims from userinfo endpoint (#3718) (90bdc61):
- feat: claims from userinfo endpoint
- chore: update libraries
- test: improve coverage
Emit error details when we find stray cookies in an API flow (#3496) (df74339)
Eventually consistency API controls (#3558) (00cf11c):

Adds a feature used in Ory Network which enables trading faster reads for slightly stale data.

This feature depends on Cockroach functionality and configuration, and is not possible for MySQL or PostgreSQL.
Extend Microsoft Graph API capabilities (#3609) (4a7bcc9):

This change queries for all user information available with the User.Read scope during OIDC, and populates the RawClaims field.
Extract identifier label for login from default identity schema (#3645) (180828e)
Fine-grained hooks for all available flow methods (#3519) (a37f6bd):

Adds fine-grained hook configurations to the post-settings flow for methods totp, webauthn, lookup_secret and the post-login flow for totp, lookup_secret, and code.
Hook to revoke sessions after password changed (#3514) (e6af6db), closes #3513:

Currently, the Kratos system does not automatically log out or invalidate other active sessions when a user changes their password. This poses a significant security risk as it allows potentially unauthorized individuals to maintain access to the account even after the password has been updated.

This PR provides the option to add the revoke_active_sessions hook to the actions sections of the selfservice settings.
Hot-reload CORS origins (#3423) (157d934)
Improve messages for easier i18n (#3457) (37f1657)
Improve performance by computing password hashes while validating (#3508) (a9786c5)
Improved webhook tracing (#3746) (9d7021d)
Jsonnet caching for OIDC claims mapper, webhooks, JWT session tokenizer (#3701) (1d26e09)
Link oidc credentials when login (#3563) (b784949), closes #2727 #3222:

When user tries to login with OIDC for the first time but has already registered before with email/password a credentials identifier conflict may be detected by Kratos. In this case user needs to login with email/password first and then link OIDC credentials on a settings screen. This PR simplifies UX and allows user to link OIDC credentials to existing account right in the login flow, without switching to settings flow.
List by OIDC cred (#3721) (bff9c61)
Login with code on any credential type (#3549) (ceed7d5):

Should be able to login with the code credential even if the user did not register on the code credential. Only identifier matching is done and validation based on the identity schema.
One-time code native flows (#3516) (9b0fee3)
Order sessions by created_at (#3696) (688111c)
Parametrize courier worker (#3601) (0e4be57):

Allows one to parametrize how many messages the courier will fetch and how often it will fetch messages.
Passwordless browser login and registration via code to email (#3378) (eaaf375), closes #2029 ory-corp/cloud#3573:

This feature adds passwordless email code login. When a user signs up, or signs in, a code is sent to their email address which they can use to complete the authentication process.

This feature is currently only working for browser facing APIs.
Pooled process-isolated Jsonnet VM (9a52ddf)
Provide login hints when registration fails due to duplicate credentials/addresses (#3430) (8b28469):
- feat: provide login hints when registration fails due to duplicate credentials or identifiers
- feat: identify edge cases and write tests
- chore: synchronize workspaces
- feat: make login hints configurable
- chore: synchronize workspaces
- chore: synchronize workspaces
- chore: synchronize workspaces
- chore: synchronize workspaces
Support auth_type parameter (#3487) (fc30304):

The Facebook OIDC provider supports an auth_type parameter that when set to "reauthenticate" will force the user to reauthenticate (similar to prompt=login for other Providers).
Support for B2B SSO (#3489) (0ec037a)
Support MFA via SMS (#3682) (1516cf6)
Support multiple origins for WebAuthN (#3380) (013f335):

Users can now supply a list of origins for webauthn in the configuration.
Support native social sign using apple sdk (#3476) (f561013)
Transmit current session ID to Hydra when accepting the login (#3426) (610c76d):
- chore: change react-native port to 19006
- feat: transmit current session ID when accepting login
- fix: upgrade hydra in tests
Webhook analytic events (9c8a25e)

Reverts

Revert "chore: simplify courier code (#3603)" (7c54c9f), closes #3603:

This reverts commit 316cd4aacfe31efafa7d737a7c476e2c794e9c9b.

Tests

Add test for link + oidc challenge (#3720) (67360cf)
e2e: Logout return_to (#3418) (c348c12)
Fix cypress setup (#3527) (70c8ddd)
Fix e2e failures and speed up e2e tests (#3483) (70a6171)
Fix hydra tests on master (#3737) (12166b4)
Reduce logging in go tests (#3562) (05de3a2)
Resolve cypress issues (#3531) (4206d26)

Unclassified

Revert "feat: extend Microsoft Graph API capabilities (#3609)" (#3717) (549308d), closes #3609 #3717:

This reverts commit 4a7bcc9322be37e6fd141e411bd65e3977eeb692.

1.0.0 (2023-07-12)

We are thrilled to announce Ory Kratos v1.0, the powerful Identity, User Management, and Authentication system! With this major update, Ory Kratos brings a host of enhancements and fixes that greatly improve the user experience and overall performance.

Several compelling reasons led to label Ory Kratos as a major release, like successfully processing over 100 million API requests daily and having about 100 million Docker Pulls. We have maintained stability within the Ory Kratos APIs for nearly two years, demonstrating their robustness and reliability. No breaking changes mean that developers can trust the stability of Ory Kratos in production.

Ory Kratos 1.0 introduces a variety of new features while focusing on stability, robustness, and improved performance. Major enhancements include support for social login and single-sign-on via OpenID connect in native apps, emails sent through HTTP rather than SMTP, and full compatibility with Ory Hydra v2.2.0. Users will also find multi-region support in the Ory Network for broader geographic reach, improved export functionality for all credential types, and enhanced session management with the introduction of the "provider ID" parameter. Other additions comprise distroless images for leaner resource utilization and faster deployment and support for the Lark OIDC provider.

Significant improvements and fixes accompany these new features. Enhanced OIDC flows now include the ability to forward prompt upstream parameters, offering developers increased flexibility and customization options. The logout flow also supports the return_to parameter, facilitating more flexible redirection post-user logout. Performance has been a key focus, with Ory Kratos 1.0 now capable of handling hundreds of millions of active users monthly. Critical bug fixes have been applied to prevent users from being redirected to incorrect destinations, ensuring smoother authentication and authorization. Additionally, there's more support for legacy systems via implemented crypt(3) hashers and a fix for metadata patching has been deployed to ensure consistent user metadata management. For a detailed view of all changes, refer to the changelog on GitHub. Feedback and support are, as always, greatly appreciated.

Ory Kratos 1.0 is a major release that marks a significant milestone in our journey.

We sincerely hope that you find these new features and improvements in Ory Kratos 1.0 valuable for your projects. To experience the power of the latest release, we encourage you to get the latest version of Ory Kratos here or leverage Kratos in Ory Network — the easiest, simplest, and most cost-effective way to run Ory.

For organizations seeking to upgrade their self-hosted solution, Ory offers dedicated support services to ensure a smooth transition. Our team is ready to assist you throughout the migration process, ensuring uninterrupted access to the latest features and improvements. Additionally, we provide various support plans specifically tailored for self-hosting organizations. These plans offer comprehensive assistance and guidance to optimize your Ory deployments and meet your unique requirements.

We extend our heartfelt gratitude to the vibrant and supportive Ory Community. Without your constant support, feedback, and contributions, reaching this significant milestone would not have been possible. As we continue on this journey, your feedback and suggestions are invaluable to us. Together, we are shaping the future of identity management and authentication in the digital landscape.

Contributors to this release in alphabetical order: borisroman, ci42, CNLHC, David-Wobrock, giautm, IchordeDionysos, indietyp, jossbnd, kralicky, PhakornKiong, sunakan, steverusso

Are you passionate about security and want to make a meaningful impact in one of the biggest open-source communities? Join the Ory community and become a part of the new ID stack. Together, we are building the next generation of IAM solutions that empower organizations and individuals to secure their identities effectively.

Want to check out Ory Kratos yourself? Use these commands to get your Ory Kratos project running on the Ory Network:

brew install ory/tap/cli

scoop bucket add ory https://github.com/ory/scoop.git
scoop install ory

bash <(curl <https://raw.githubusercontent.com/ory/meta/master/install.sh>) -b . ory
sudo mv ./ory /usr/local/bin/

ory auth

ory create project --name "My first Kratos project"

ory open account-experience registration

ory patch identity-config \\
  --replace '/identity/default_schema_id="preset://username"' \\
  --replace '/identity/schemas=[{"id":"preset://username","url":"preset://username"}]' \\
  --format yaml

ory open account-experience registration

Bug Fixes

Ability to patch metadata even if it is null (#3304) (3c04d8f)
Accept OIDC login request in browser+JSON login flow (#3271) (ad54093):
- fix: OIDC login in browser JSON flow
- test: add test for OIDC+JSON continuity cookie
Add error checking when creating verification code (#3328) (7182eca)
Add missing SessionIssued event for api flows (#3348) (adf78e0):
- fix: missing SessionIssued event for api flows
- chore: add SessionIssued event to post registration hook
- chore: format
- chore: move sessionissued event to persister
Bump quickstart version (#3257) (6db70a8)
Cypress TOTP test (eac908c)
Do not require items to be unique (#3349) (17be30d)
Don't assume the login challenge to be a UUID (#3317) (3172862):

For compatibility with ory/hydra#3515, which now encodes the whole flow in the login challenge, we cannot further assume that the challenge is a UUID.
e2e: Install kratos-selfservice-ui-node peer deps (#3354) (ce20063)
Identity list pagination (#3325) (9d3ef0d):

Resolves a pesky issue that would skip the last page.
IdentityCreated event (#3314) (78e31cb)
Incorrect override in identity hydrate (#3368) (eaa3f3c)
Increase size for request url (#3366) (10713cc)
Minor refactorings in package hash (#3186) (831fb19)
Missing id for login event (#3315) (b6b80a3)
Properly normalize uppercase mail addresses (4984e0f):

Fixes ory#3187 Fixes ory#3289
Provide index hint in QueryForCredentials (#3329) (4ba530e):
- fix: provide index hint in QueryForCredentials
- feat: remove customizable join predicate in QueryForCredentials
- chore: remove obsolete config tracer
Reduce lookups in whoami call (#3364) (5bb7b0c)
Reintroduce ExpandAll (#3369) (8f9bff5)
Remove codeball (aa29606)
Remove duplicate SessionIssued event (#3351) (b1e78ad)
Return HTTP 400 instead of 500 for bad query parameters (58258eb)
sdk: Add cookie for updateLogoutFlow (#3284) (95ed2b9):

Closes ory/sdk#255
sdk: Update the API spec to reflect the 204 NoContent in DeleteIdentityCredentials (#3347) (f3dee86)
Settings should persist return_to after required mfa login flow (#3263) (0ed1abd):
- fix: get settings should persist return_to when redirecting to aal2
- feat(e2e): verify return_to persists in recovery flows
- test: recovery strategy with mfa account
- test: code recovery return to persists to settings with aal2
- u
- fix: return to settings flow after mfa login
- fix(test): login handler
- fix: flow between settings and mfa
- fix: get settings endpoint should redirect to settings ui instead of to itself
- feat(test): preserve URL from various settings flows through login mfa flow
- chore: cleanup
- fix(e2e): recovery return to spa tests
- fix: e2e proxy
- fix: do not always redirect back to settings on mfa
- fix: new settings flow with required mfa shouldn't be added to login flow return_to unless it contains a return_to parameter
- fix(e2e): let test dynamically handle required_aal
- chore: cleanup unused code
- test: DoesSessionSatisfy with method options
- test: recovery strategy with aal2
String to enum for updateVerificationFlowWithLinkMethod Method (#3279) (34ff1d2), closes #2943
Update correct typo (#3281) (0fea75c):

The text for verification code input should be Verification code not Verify code.
Update README (#3363) (c426014)
Use RETURNING clause for batch create (#3293) (8ae8783)
Use the correct redirect_uri for linkedin social login (#3269) (27ccecc)
Webhook config parse for settings flow (#3305) (95ad94d)

Code Generation

Pin v1.0.0 release commit (41b7c51)

Documentation

Fix typo in readme (#3299) (b40544e)

Features

Add “provider id” parameter to kratos session (#3292) (387f5a2), closes #3283
Add distroless and static images (#3350) (1e65662)
Add return_to parameters to the createLogout handler (#3336) (08fed36):
- feat: add return_to parameters to the createLogout handler
- test: logout take over return_to from create to update
- test(e2e): logout return to
- test(e2e): logout return to
- test: logout return_to isnt applicable to react
Allow customization of JOIN predicate in QueryForCredentials (#3253) (8785166)
Emit events for login/logout and registration (#3235) (c784b7e)
Forward prompt upstream parameter during OIDC flow (#3276) (d290cb0), closes #2709
Implement crypt(3) hashers (#3303) (afe06db), closes #3291:

This PR implements md5crypt, sha256crypt, sha512crypt, which are considered legacy (like md5), but are used in legacy systems looking to convert to ory. They use the existing format of crypt(5) (which is compliant to PHC).
Improve event types and capture more events (#3297) (835fe13)
Lark OIDC provider (#2925) (f884dfb)
Return to oauth flow after switching from login to other flows (#3212) (a1fea6c):
- feat: return to oauth flow after switching from login to other flows
- feat(e2e): flows should have return_to set to hydra request_url
- u
- fix: override return_to URL on OAuth flows
- style: format
- fix: TestOAuth2Provider
- feat: config to opt into using OAuth request url as return_to
- chore: cleanup
- fix(e2e): oauth2 login flow switching to recovery
- feat(test): oauth2 login flow to recovery through oidc provider
- fix(e2e): oidc-provider registration
- chore: rename oauth2_provider.return_to_enabled to oauth2_provider.override_return_to
- style: format
- chore: nit config description
Sort sessions by authenticated_at (#3324) (46f92ff):

Closes ory/network#295
Sqa metrics v2 (#3300) (98fe73f)
Support exporting of all credential types (#3290) (de6c857):

It's now possible to export all credential types (including passwords) when calling the getIdentity SDK method.
Support OIDC flows for native apps (#3216) (cb10609), closes #707:

Implements Social Sign In and OpenID Connect for native apps.

Tests

Run Playwright in CI (#3259) (342edec):
- run Playwright in CI
- add cleanup for session token exchangers
- fixup: ci
- fix: compatibility between OIDC+code and other flows
This improves the compatibility between OIDC+code and other flows such as TOTP, settings, password auth.
- Update persistence/sql/persister_cleanup_test.go
- fix: error handling with OIDC+Code
- fix: increase playwright timeout

Unclassified

@barnarddt @hperl feat: send emails via http api endpoint instead of smtp (#1030) (#3341) (28b7b04), closes #1030 #3341 #1030 #3008:

This change adds a new delivery method to the courier called mailer. Similar to SMS functionality it posts a templated Data model to a API endpoint. This API can then send emails via a CRM or any other mechanism that it wants.

Mailer still uses the existing email data models so any new email added will automatically be sent to the API/CRM as well.

Related issue(s)

Resolves ory#2825

0.13.0 (2023-04-18)

We’re excited to announce the release of Ory Kratos v0.13.0! This update brings many enhancements and fixes, improving the user experience and overall performance. Here are the highlights:

We’ve added new social sign-in options with Patreon OIDC and LinkedIn providers, making it even easier for your users to register and log in. Furthermore, we’ve introduced a new admin API that allows you to remove specific 2nd factor credentials, giving you more control over your user accounts.
Performance has been a key focus in this release. We’ve optimized the whoami calls, parallelized the getIdentity and getSession calls, and made asynchronous webhooks fully async. These improvements will result in faster response times and a smoother experience for your users. Additionally, we’ve implemented better tracing to help you diagnose and resolve issues more effectively.
We’ve also made several updates to the webhook system. A new response.parse configuration has been introduced, allowing you to update identity data during registration. This includes admin/public metadata, identity traits, enabling/disabling identity, and modifying verified/recovery addresses. Please note that can_interrupt is now deprecated in favor of response.parse.
Lastly, we’ve made several important fixes, such as resolving the wrong message ID on resend code buttons, implementing the offline scope as Google expects, and improving the OIDC flow on duplicate account registration. We’ve also added the ability to configure whether the system should notify unknown recipients when attempting to recover an account or verify an address, enhancing security with “anti-account-enumeration measures.”

We hope you enjoy these new features and improvements in Ory Kratos v0.13.0! All features are already live on the Ory Network - the simplest, fastest and most scalable way to run Ory.

Please note that the v0.12.0 release was skipped due to CI issues.

Head over to the changelog at https://github.com/ory/kratos/blob/master/CHANGELOG.md to read all the details. As always, we appreciate your feedback and support!

Breaking Changes

By default, Kratos no longer sends out these Emails. If you want to keep notifying unknown addresses (keep the current behavior), set selfservice.flows.recovery.notify_unknown_recipients to true for recovery, or selfservice.flows.verification.notify_unknown_recipients for verification flows.

Bug Fixes

Access rules example (#3178) (a206772)
Account experience redirects to verification page (#3195) (2e96d75)
Account settings broken on OIDC removal (#3185) (61ae531), closes ory-corp/cloud#3514
Add after_verification_return_to to sdk and api docs (#3097) (c70704c), closes #3096
Add HydraLoginRequest on flow creation (#3152) (09312dd), closes #3108:

The oauth2_login_request field was missing when initially creating the login flow.
Add missing code discriminator in updateVerificationFlow (#3213) (21576be)
Add missing index (#3181) (756bed4)
Add mutex to test SMTP server setup/teardown (20c2359)
Avoid unchecked casts from IdentityPool to PrivilegedIdentityPool (71d35dd)
Correctly apply patches to identity metadata (#3103) (1193a56), closes #2950
Do not omit last page on identity list (#3169) (f95f48a)
Don't return 500 if active strategy is disabled (#3197) (3a734c2)
Don't reuse ports in courier/SMTP tests (#3156) (e260fcf)
Don't treat missing session as error in tracing (290d28a)
Error messages in OpenAPI/Swagger / improve error messages from failed webhooks and client timeouts (#3218) (b1bdcd3)
Handle upstream errors in patreon provider (#3032) (39fa31f)
Identity.CopyWithoutCredentials (989c99d)
Implement offline scope in the way google expects (#3088) (39043d4)
Improve webhook resilience (#3200) (0a05d99):
- fix: improve webhook logging
- chore: bump x
- feat: decouple context in PostRegistrationPostPersist hook
Invalid SQL syntax in ListIdentities (#3202) (162ab9b):

PostgresQL does not support ... WHERE x IN ( ) with an empty argument list.
Issuer missing from netid claims (#3080) (dec7cbc):

The NetID provider omits the issuer claim in the userinfo response. To resolve this issue, the ID token returned by NetID is now validated and its sub and iss values are used.
Lint errors and unused code (ae49ef0)
Make async webhooks fully async (#3111) (342bfb0)
Make session AAL satisfaction check resilient against a nil identity in the session (5ab1a56):

Also fix tracing.
Missing issuer regression in OIDC (#3220) (52f0740):

Closes ory#3182 Closes ory#3040
Nolint comment (93e6501)
Only return one result set for credentials_identifier (#3107) (59f35d1), closes #3105
Orphaned webhook spans (a7f9414)
Re-use existing CSRF token in verification flows (#3188) (08a3447):
- fix: re-use existing CSRF token in verification flows
- chore: fix if/else
Reduce SQL tracing noise (1650426)
Remove http.Redirect from show_verification_ui hook (#3238) (054705b)
Remove network omit flag (#3066) (c629b72)
Report correct errors for json schema validation (#3085) (9477ea4):
- Implemented the translation of jsonschema.ValidationError to errors codes documented here
- Added missing error codes for relevant schema errors | Validation | Name | ID | | ------------------ | ------------------------------- | ------- | | maxLength | ErrorValidationMaxLength | 4000017 | | minimum | ErrorValidationMinimum. | 4000018 | | exclusiveMinimum | ErrorValidationExclusiveMinimum | 4000019 | | maximum | ErrorValidationMaximum | 4000020 | | exclusiveMaximum | ErrorValidationExclusiveMaximum | 4000021 | | multipleOf | ErrorValidationMultipleOf | 4000022 | | maxItems | ErrorValidationMaxItems | 4000023 | | minItems | ErrorValidationMinItems | 4000024 | | uniqueItems | ErrorValidationUniqueItems | 4000025 | | type | ErrorValidationWrongType | 4000026 |
- Updated e2e tests to check these IDs explicitly
Respect the after recovery return to URL from config (#3141) (3467fd3):

Fixes https://github.com/ory-corp/cloud/issues/1405
Set DB connection max idle time (8d4762c)
Set proper maxAge for session cookies (#3209) (1180c05), closes #3208
Sqa config values unified across projects (#3237) (523b93f)
Test contract names (e9ac00b)
Use correct names in WebAuthN dialogs (#3215) (3bc1ff0)
Use type alias instead of type definition (#3148) (dba3803)
Webhook tracing and missing defers (#3145) (46eb063)
Wrong context in logout trace span (#3168) (b9ccccf)

Code Generation

Pin v0.13.0 release commit (349d0ee)

Code Refactoring

Identity persistence (#3101) (ceb5cc2)

Documentation

Fix broken docs links and code example to get verification flow (#3170) (bdbddcc)
Update security email (#3164) (9252f5a)

Features

Add a new admin API to remove a specific 2nd factor credential (#2962) (44556a4), closes #2505
Add API to batch insert identities (#3157) (829bda7), closes ory/network#266
Add Inspect option to driver (8aa75e9)
Add patreon oidc provider (#3021) (20ea29e)
Add test to verify GetIdentityConfidential expands everything (#3217) (f088ccd)
Add token prefixes to session and logout tokens (#3132) (8210cd0):

This feature adds token prefixes to Ory session and logout tokens:
- ory_st_: Ory session token prefix
- ory_lt_: Logout token prefix
Add upstream parameters to oidc provider (#3138) (b6b1679), closes #3127 #2069:

This PR introduces the upstream OIDC query parameters login_hint and hd.

To send additional upstream parameters the form can post this on a login, registration or settings link submit. For example the form below does an OIDC flow to Google. We can now add additional parameters such as login_hint and hd to the upstream request to Google login with a pre-filled email email@example.com:
```
<form action="https://kratos/self-service/login?flow=">
  <input type="submit" name="provider" value="google" />
  <input
    type="hidden"
    name="upstream_parameters.login_hint"
    value="email@example.com"
  />
  <input type="hidden" name="upstream_parameters.hd" value="example.com" />
</form>
```
Allow importing (salted) SHA hashing algorithms (#2741) (132255e), closes #2422
Allow passing transient data from registration to webhook (#3104) (4a3a076)
Don't pre-generate UUIDs for transient objects (e17f307)
Drop unused index (#3165) (852dea9)
Even more tracing of hidden HTTP requests (9d8b1e2)
Identity by identifier (#3077) (c288d4d)
Improve tracing span naming in hooks (bf828d3)
Improve webhook diagnostics (d4eb2f6)
Improved oidc flow on duplicate account registration (#3151) (4d2fda4):

This PR improves the OIDC registration flow when a duplicate account error happens.

Currently the flow looks as follows:
1. User registers with password (or other credentials)
2. User forgot they registered with password and tries to login through an OIDC provider (e.g. Google)
3. Kratos attempts a registration since the OIDC credentials do not exist
4. (optional) User needs to add missing traits (e.g. full name) which could not be retrieved from the OIDC provider
5. User gets a duplicate account error with a "Continue" button.
6. After submitting the "Continue" button the flow continues again to the OIDC provider, back to Kratos and redirects to UI with duplicate error (Steps 3 to 5)
Instead of causing a confusing redirect loop we should show the user the error with a fresh login flow (since the account exists). This also gives the user the option to do a recovery flow.
1. User registers with password (or other credentials)
2. User forgot they registered with password and tries to login through an OIDC provider (e.g. Google)
3. Kratos attempts a registration since the OIDC credentials do not exist
4. (optional) User needs to add missing traits
5. User is returned to a Login flow with the duplication error
Let DB generate ID for session devices (62402c7)
Make notification to unknown recipients configurable (#3075) (1a5ead4), closes #2345 #2585:

Added the ability to configure whether the system should notify unknown recipients, if some tries to recover their account or verify their address ("anti-account-enumeration measures").
Make password validator (HIBP check) cancelable and add tracing (28f8914)
Parallelize get identity and session calls (#3023) (6393519)
Refactor credentials fetching (#3183) (590269f):

This change revamps the way we fetch identity credentials. We no longer need most of the helper fields for gobuffalo/pop inside the Identity and Credentials structures, and we collect all the credentials in one joined query rather than using pop's EagerPreload functionality.
Return hydra error messages (b3d037b)
Return verification flow ID after registration flow (#3144) (eb854be), closes #2975
Show "continue" screen after successful verification (#3090) (fb6b160), closes /github.com/ory-corp/cloud#3925 /github.com/ory/network#228:

The link strategy for verification now shows a confirmation screen with a "continue" link after successful verification, aligning its behavior to the code strategy.

Also fixes a bug, where the default_browser_return_url of the verification flow was not respected when using the code strategy.
Social sign in via linkedin (#3079) (5de6bf4), closes #2856:

Adds LinkedIn as a social sign in provider.
Webhooks that update identities (2cbee3e), closes #2161:

Introduces a new configuration response.parse in webhooks. This enables updating of identity data during registration, including admin/public metadata, identity traits, enabling/disabling identity, and modifying verified/recovery addresses.

Please note that can_interrupt is being deprecated in favor of response.parse.

Tests

e2e: Fix compile errors in commands (#3179) (0002668)
Parallelize several unit tests (#3081) (5403f86)

Unclassified

Revert "fix: do not omit last page on identity list (#3169)" (#3184) (73b5f13), closes #3169 #3184:

This reverts commit f95f48a79395b7b99c7482c0974bc5188e007cc0.

0.11.1 (2023-01-14)

Fixed several bugs to improve overall stability.
Optimized performance for faster load times and smoother operation.
Improved tracing capabilities for better debugging and issue resolution.

We are constantly working to improve Ory Kratos and this release is no exception. Thank you for using Ory and please let us know if you have any feedback or encounter any issues.

Breaking Changes

The /admin/courier/messages endpoint now uses keysetpagination instead.

Bug Fixes

Add missing indexes (#2973) (bbb3995)
Add missing indexes for identity delete (#2952) (dc311f9):

This significantly improves the performance of identity deletes.
Cors headers not added to the response #2922 (#2934) (1ed6839)
Dont reset to false (#2965) (ae8ad7b)
Flaky test now stable (4e5dcd0)
Listing sessions query (#2958) (3e06c99), closes #2930
Missing index on courier list count (#3002) (3b50711)
Pin geckodriver version to bypass GitHub API quota (#2972) (585cb9e)
Quickstart demos (#2940) (a7720b2)
Remove duplicate query in GetIdentity (#2987) (33b01bb)
Remove unused x-session-cookie parameter (#2983) (56b5c26):

This patch removes the undocumented and experimental X-Session-Cookie header from the /sessions/whoami endpoint.
Resilient social sign in (#3011) (ca35b45)
Respect return_to URL parameter in registration flow when the user is already registered (#2957) (3462ce1)
Set accept header for GitLab (#2998) (e892113)
Set config at the start (e58bc6e)
Spurious cancelation of async webhooks, better tracing (#2969) (72de640):

Previously, async webhooks (response.ignore=true) would be canceled early once the incoming Kratos request was served and it's associated context released. We now dissociate the cancellation of async hooks from the normal request processing flow.
TOTP internal context after saving settings (#2960) (8b647b1), closes #2680
Update pquerna/otp to fix TOTP URL encoding (#2951) (7248636):

v1.4.0 fixes generating TOTP URLs. Query params now use %20 instead of + to encode spaces. + was not correctly interpreted by some Android authenticator apps, and would show up in the issuer name, e.g. "My+Issuer" instead of "My Issuer".
Update year (d77e2cf)
Webhook tracing instrumentation+memory leak (f0044a3)

Code Generation

Pin v0.11.1 release commit (41595c5)

Documentation

Improve api headline (#2989) (fc2787b)

Features

Add client IP to span events (7ce3a74)
Add NID to logs in courier (#2956) (b407aa9)
Improve error message when no session is found (#2988) (7ad2b97)
Improve tracing (#2992) (04d0280)
Remove duplicate queries from whoami calls (#2995) (b50a222), closes #2402:

Introduces an expand API to the identity persister which greatly improves whoami performance.
Require verification on login (#2927) (efb8ae8)
Store errors of courier message (#2914) (fc7aa86)

Tests

Improve parallelization (e8e8ce5)
Regenerate csrf if verification flow expired (#2455) (7025081)
Update integrity snapshots (#3000) (6d26e5c)

0.11.0 (2022-12-02)

The 2022 winter release of Ory Kratos is here, and we are extremely excited to share with you some of the highlights included:

Ory Kratos now supports verification and recovery codes, which replace are now the default strategy and should be used instead of magic links.
Import of MD5-hashed passwords is now supported.
Ory Kratos can now act as the login app for the Ory Hydra Consent & Login Flow using the oauth2_provider.url configuration value.
Ory Kratos' SDK is now released as version 1. Learn more in the upgrade guide.
New APIs are available to manage Ory Sessions.
Ory Sessions now contain device information.
Added all claims to the Social Sign-In data mapper as well as the option to customize admin and public metadata.
Add webhooks that can block the request, useful to do some additional validation.
Add asynchronous webhooks which do not block the request.
A CLI helper to clean up stale data.

Please read the changelog carefully to identify changes which might affect you. Always test upgrading with a copy of your production system before applying the upgrade in production.

Code Generation

Pin v0.11.0 release commit (59c30b6)

Features

Forward parsed request cookies to webhook Jsonnet snippet (#2917) (70ed068):

Request cookies were already available in raw form in the ctx.request_headers top-level argument to the Jsonnet snippet. Parsing cookies in Jsonnet is tedious and error-prone, though, so we parse them internally for convenience.

0.11.0-alpha.0.pre.2 (2022-11-28)

autogen: pin v0.11.0-alpha.0.pre.2 release commit

Breaking Changes

This patch changes the behavior of the recovery flow. It introduces a new strategy for account recovery that sends out short "one-time passwords" (code) that a user can use to prove ownership of their account and recovery access to it. This PR also updates the default recovery strategy to code.

This patch invalidates recovery flows initiated using the Admin API. Please re-generate any admin-generated recovery flows and tokens.

This is a breaking change, as it removes the courier.message_ttl config key and replaces it with a counter courier.message_retries.

Closes ory#402 Closes ory#1598

SDK Method getJsonSchema was renamed to getIdentitySchema.

Bug Fixes

Active attribute based off IsActive checks (#2901) (bcbf68e)
Add issuerURL for apple id (#2565) (2aeb0a2):

No issuer url was specified when using the Apple ID provider, this forced usersers to manually enter it in the provider config.

This PR adds the Apple ID issuer url to the provider simplifying the setup.
Add missing go.mod to docker build (7c4964e)
Add support for verified Graph API calls for facebook oidc provider (#2547) (1ba7c66)
Admin recovery CSRF & duplicate form elements (#2846) (de80b7f)
Bump docker image (#2594) (071c885)
Bump graceful to deal with http header timeouts (9ce2d26)
Cache migration status (#2631) (9020738):

See https://github.com/ory-corp/cloud/issues/2691
Check return code of ms graphapi /me request. (#2647) (3f490a3)
cli: Dry up code (#2572) (d1b6b40)
Codecov (#2879) (e446c5a)
Correct name of span on recovery code deletion (#2823) (44f775f)
Correctly calculate expired_at timestamp for FlowExpired errors (#2836) (ddde43e)
Debugging Docker setup (#2616) (aaabe75)
Disappearing title label on verification and recovery flow (#2613) (29aa3b6), closes #2591
Distinguish credential types properly when collecting identifiers (#2873) (705f7b1)
Do not crash process on invalid smtp url (#2890) (c5d3ebc):

Closes https://github.com/ory-corp/cloud/issues/3321
Do not double-commit webhooks on registration (#2888) (88e75d9)
Do not invalidate recovery addr on update (#2699) (1689bb9)
docker: Add missing dependencies (#2643) (c589520)
docker: Update images (b5f80c1)
Duplicate messages in recovery flow (#2592) (43fcc51)
Express e2e tests for new account experience (#2708) (84ea0cf)
Format (0934def)
Format check stage in the CI (#2737) (bbe4463)
Gosec false positives (e3e7ed0)
Identity sessions list response includes pagination headers (#2763) (0c2efa2), closes #2762
identity: Migrate identity_addresses to lower case (#2517) (c058e23), closes #2426
Ignore commata in HIBP response (0856bd7)
Ignore CSRF for session extension on public route (866b472)
Ignore error explicitly (772d596)
Improve migration status speed (#2637) (a2e3c41)
Include flow id in use recovery token query (#2679) (d56586b):

This PR adds the selfservice_recovery_flow_id to the query used when "using" a token in the recovery flow.

This PR also adds a new enum field for identity_recovery_tokens to distinguish the two flows: admin versus self-service recovery.
Include metadata_admin in admin identity list response (#2791) (aa698e0), closes #2711
Incorrect swagger annotation for getSession (#2891) (797ea68)
lint: Fixed lint error causing ci failures (4aab5e0)
Make courier.TemplateType an enum (#2875) (65aeb0a)
Make hydra consistently localhost (70211a1)
Make ID field in VerifiableAddress struct optional (#2507) (0844b47), closes #2506
Make servicelocator explicit (4f841da)
Make swagger/openapi go 1.19 compatible (fec6772)
Mark gosec false positives (13eaddb)
Metadata should not be required (05afd68)
Migration error detection (a115486)
Missing usage to recovery_code_invalid template (#2798) (5ac7553)
Not cleared field validation message (#2800) (cdaf68d)
Panic (1182278)
Patch invalidates credentials (#2721) (c4d95af), closes ory/cloud#148
Potentially resolve tx issue in crdb (#2595) (9d22035)
Preserve return_to param between flows (#2644) (f002649)
Proper annotation for patch (#2784) (0cbfe41)
Re-add service to quickstart (8c52c33)
Re-issue outdated cookie in /whoami (#2598) (bf6f27e), closes #2562
Remove jackc rewrites (#2634) (fe00c5b)
Remove jsonnet import support (d708c81)
Remove newline sign from email subject (#2576) (ca3d9c2)
Remove rust workaround (355ec43)
Replace io/util usage by io and os package (e2d805b)
Resolve bug where 500s in web hooks are not properly retried (e572e81)
Respect more http sources for computing request URL (66a9448)
Return browser to 'return_to' when logging in without registered account using oidc. (#2496) (a4194f5), closes #2444
Return empty array not null when there are no sessions (#2548) (fffba47)
Revert Go 1.19 formatting changes (7fb085b)
Revert removal of required field in uiNodeInputAttributes (#2623) (fee154b)
sdk: Identity metadata is nullable (#2841) (4c70578):

Closes ory/sdk#218
sdk: Make InputAttributes.Type an enum (ff6190f)
sdk: Rust compile issue with required enum (#2619) (8800085)
Send out correct verification invalid email in code strategy (#2908) (d2bb67a)
Set cache default to false (#2906) (e407f92)
Take over return_to param from unauthorized settings to login flow (#2787) (504fb36)
Unable to find JSON Schema ID: default (#2393) (f43396b)
Use correct download location for golangci-lint (c36ca53)
Use errors instead of fatal for serve cmd (02f7e9c)
Use full URL for webhook payload (72595ad)
Use process-isolated Jsonnet VM (#2869) (9eeedc0)
Verification redirect & continue label (#2905) (e1119e8):

This PR resolves an issue with the redirect after a successful verification, if not specified.
Wrap migration error in WithStack (#2636) (4ce9f1e)
Wrong config key in admin recovery documentation (#2815) (154b61b)
X-forwarded-for header parsing (#2807) (4682afa)

Code Generation

Pin v0.11.0-alpha.0.pre.2 release commit (624e1f0)

Code Refactoring

Hot reloading (b0d8f38)
Make embedding easier with internal sdk (e9aa21f)
SDK v1 naming (11f9d30):

Find the full upgrade guide in our documentation.
sdk: Rename getJsonSchema to getIdentitySchema (#2606) (8dc2ecf)
Use gotemplates for command usage (baa84c6)
Use gotemplates for command usage (#2770) (1d22b23)

Documentation

Cleanup v0alpha2 endpoint summaries (db9a95b)
Cypress on arm based mac (#2795) (d8514b5)
Enable 2FA methods in docker-compose quickstart setup (#2828) (8f52e8b)
Fix badge (dbb7506)
Importing credentials supported (4e8b5cf)
sdk: Identifier is actually required (#2593) (f89d279)
sdk: Incorrect URL (#2521) (ac6c4cc)
Update README (5da4c6b)
Update readme badges (7136e94)
Write messages as single json document (#2519) (3d8cf38), closes #2498

Features

Add "success" UITextType (#2900) (2ff34b6)
Add admin get api for session (#2855) (1aa1321)
Add api endpoint to fetch messages (#2651) (5fddcbf):

Closes ory#2639
Add autocomplete attributes (#2523) (6284a9a), closes #2396
Add cache headers (#2817) (71e2449)
Add codecov yaml (90da0bb)
Add DingTalk social login (#2494) (7b966bd)
Add flow id check to use verification token (#2695) (54c64fc)
Add handler with openapi def for admin revoke session (#2867) (2438ca0)
Add identity id to "account disabled" error (#2557) (f09b1b3)
Add missing config entry (8fe9de6)
Add missing cookie headers to SDK methods (#2720) (32e32d1):

See ory#2583
Add OpenTelemetry span events (#2858) (37b1a3b)
Add PATCH to adminUpdateIdentity (#2380) (#2471) (94a3741)
Add pre-hooks to settings, verification, recovery (c0ceaf3)
Add session cache header feature flag (#2899) (02a92b4), closes ory-corp/cloud#3283
Add support for firebase scrypt hashes on identity import and login hash upgrade (#2734) (3852eb4), closes #2422
Add verification via code (#2838) (a82ee92), closes #2824:

The new code strategy is now supported as a verification strategy. If enabled, the strategy sends a code, instead of a magic link to the user's address, which they can use to verify their address.
Adding admin session listing api (#2818) (59588d2)
Adding device information to the session (#2715) (82bc9ce):

Closes ory#2091 See https://github.com/ory-corp/cloud/issues/3011

Co-authored-by: Patrik zepatrik@users.noreply.github.com
Allow importing scrypt hashing algorithm (#2689) (3e3b59e), closes #2422:

It is now possible to import scrypt-hashed passwords.
Allow setting public and admin metadata with the jsonnet data mapper (#2569) (aa6eb13), closes #2552
Automatic TLS certificate reloading (#2744) (09751e6)
Change code length to 6 numbers (#2894) (56feb07)
cli: Helper for cleaning up stale records (#2406) (29d6376), closes #952
Handler for update API with credentials (#2423) (561187d), closes #2334
Immutable cookie session values (#2761) (a6f2793), closes #2701
Implement blocking webhooks (#1585) (e48e9fa), closes #1724 #1483
Improve cache handling (6e8579b)
Improve state generation logic (546ee3d)
Ingest hydra bugfix (3c11216)
OAuth2 integration (#2804) (7c6eb2a):

This feature allows Ory Kratos to act as a login provider for Ory Hydra using the oauth2_provider.url configuration value.

Closes ory#273 Closes ory#2293 See ory/kratos-selfservice-ui-node#50 See ory/kratos-selfservice-ui-node#68 See ory/kratos-selfservice-ui-node#108 See ory/kratos-selfservice-ui-node#111 See ory/kratos-selfservice-ui-node#149 See ory/kratos-selfservice-ui-node#170 See ory/kratos-selfservice-ui-node#198 See ory/kratos-selfservice-ui-node#207
Parse all id token claims into raw_claims (#2765) (1da0cf6), closes #2528:

All ID Token claims resulting from the Social Sign In flow are now available in raw_claims and can be used in the Social Sign In JsonNet Mapper.
Replace magic links with one time codes in recovery flow (#2645) (a1532ba), closes #1451:

This feature introduces a new code strategy to recover an account.

Currently, if a user needs to initiate a recovery flow to recover a lost password/MFA/etc., they’ll receive an email containing a “magic link”. This link contains a flow_id and a recovery_token. This is problematic because some antivirus software opens links in emails to check for malicious content, etc.

Instead of the magic link, we send an 8-digit code that is clearly displayed in the email or SMS. A user can now copy/paste or type it manually into the text-field that is shown after the user clicks “submit” on the initiate flow page.
Replace message_ttl with static max retry count (#2638) (b341756):

This PR replaces the courier.message_ttl configuration option with a courier.message_retries option to limit how often the sending of a message is retried before it is marked as abandoned.
Standardize license headers (#2790) (8406eaf)
Support ip exceptions (de46c08)
Support md5 hash import (#2725) (d1b4e17)
Trace WebHooks (#2911) (665605b):

Previously the context was not propagated to the http client. As a result the (instrumented) client did not find the existing span and the sapns for outgoing http request have been orphains.

With this simple Fix they are now children of the corresponding webhook spans.
Update for the Ory Network (#2814) (3e09e58)
Upgrade hydra to v2 (fdb108f)

Reverts

Revert "autogen(openapi): regenerate swagger spec and internal client" (24eddfb):

This reverts commit 4159b93ae3f8175cf7ccf77d34e4a7a2d0181d4f.

Tests

e2e: Add typescript (37018c0)
e2e: Fix flaky assertions (21a8487)
e2e: Fix issuer config (32454d2)
e2e: Fix webauthn regression (26001e7)
e2e: Improve webauthn test reliability (4d323d0)
e2e: Migrate to cypress 10.x (317fab0)
e2e: Resolve flaky hydra configuration (d8c82da)
e2e: Resolve max-age and issuer regression (0ee4cf0)
e2e: Resolve max-age regression (904f75d)
e2e: Use correct dir (907dbe3)
Fix broken assertions (e5f1311)
Fix oidc test regression (6c14b68)
Improve e2e tooling (390ccaa)
Parallelize and speed up config tests (#2611) (d8dea01)
Resolve builder regression (934c30d)
Try and recover from allocated port error (3b5ac5f)
Update snapshots (#2877) (cbaaceb)

Unclassified

Revert "refactor: use gotemplates for command usage (#2770)" (#2778) (d612612), closes #2770 #2778:

This reverts commit 1d22b235291ce7102dd186a53a431b55780973d3.
Remove empty script (#2739) (1515b83), closes #2739

0.10.1 (2022-06-01)

Re-release the SDK.

Bug Fixes

Bump ory cli (12ceae0)

Code Generation

Pin v0.10.1 release commit (ab16580)

0.10.0 (2022-05-30)

We achieved a major milestone - Ory Kratos is out of alpha! Ory Kratos had no major changes in the APIs for the last months and feel confident that no large breaking changes will need to be introduced in the near future.

This release focuses on quality-of-live improvements, resolves several bugs, irons out developer experience issues, and introduces session renew capabilities!

Breaking Changes

Please be aware that the SDK method signatures for submitSelfServiceRecoveryFlow, submitSelfServiceRegistrationFlow, submitSelfServiceLoginFlow, submitSelfServiceSettingsFlow, submitSelfServiceVerificationFlow might have changed in your SDK.

This patch moves several CLI command to comply with the Ory CLI command structure:

- ory identities get ...
+ ory get identity ...

- ory identities delete ...
+ ory delete identity ...

- ory identities import ...
+ ory import identity ...

- ory identities list ...
+ ory list identities ...

- ory identities validate ...
+ ory validate identity ...

- ory jsonnet format ...
+ ory format jsonnet ...

- ory jsonnet lint ...
+ ory lint jsonnet ...

This patch moves several CLI command to comply with the Ory CLI command structure:

- ory identities get ...
+ ory get identity ...

- ory identities delete ...
+ ory delete identity ...

- ory identities import ...
+ ory import identity ...

- ory identities list ...
+ ory list identities ...

- ory identities validate ...
+ ory validate identity ...

- ory jsonnet format ...
+ ory format jsonnet ...

- ory jsonnet lint ...
+ ory lint jsonnet ...

Bug Fixes

Add flow id when return_to is passed to the verification (#2482) (c2b1c23)
Add indices for slow queries (e0cdbc9)
Add legacy session value (ecfd052), closes #2398
auth0: Created_at workaround (#2492) (52a965d), closes #2485
Avoid excessive memory allocations in HIBP cache (#2389) (ee2d410), closes #2354
Change SQLite database mode to 0600 (#2344) (0e5d3b7):

The default mode is 0644, which is allows broader access than necessary.
Compile issues from merge conflict (#2419) (85a90c8)
Correct location (b249aaa)
courier: Add ability to specify backoff (#2349) (bf970f3)
Do not expose debug in a response when a schema is not found (#2348) (aee2b1e)
Do not fail release if no changes needed (114c93e)
Dockerfile: Use existing builder base image (#2390) (37de25a)
Embed schema (b797bba)
Get user first name and last name from Apple (#2331) (4779909)
Improve error reporting from OpenAPI (8a1009b)
Improve performance of identity schema call (af28de2)
Internal Server Error on Empty PUT /identities/id body (#2417) (5a50231)
Load return_to and append to errors (#2333) (5efe4a3), closes #2275 #2279 #2285
Make delete formattable (0005f35)
Mark body as required (#2479) (c9ae117)
New issue templates (b9ad684)
Openapi regression (#2465) (37a3369)
Quickstart docker-compose (#2490) (9717762), closes #2488
Refresh is always false when session exists (d3436d7), closes #2341
Remove required legacy field (#2410) (638d45c)
Remove wrong templates (4fe2d25)
Reorder transactions (78ca4c6)
Resolve index naming issues (d5550b5)
Resolve MySQL index issues (50bdba9)
Resolve otelx panics (6613a02)
sdk: Improved OpenAPI specifications for UI nodes (#2375) (a42a0f7), closes #2357
Serve.admin.request_log.disable_for_health behaviour (#2399) (0a381fa)
sql: Add additional join argument to resolve MySQL query issue (854e5cb), closes #2262
Unreliable HIBP caching strategy (#2468) (93bf1e2)
Use path instead of filepath to join http route paths (16b1244), closes #2292
Use JOIN instead of iterative queries (0998cfb), closes #2402
Use pointer of string for PasswordIdentifier in example code (#2421) (61f12e7)
Use predictable SQLite in memory DSNs (#2415) (51a13f7), closes #2059

Code Generation

Pin v0.10.0 release commit (87e0de7)

Code Refactoring

Deprecate fizz renderer (5277668)
Move CLI commands to match Ory CLI structure (d11a9a9)
Move CLI commands to match Ory CLI structure (73910a3)

Documentation

Add docs about change in default schema (#2447) (5093cd4)
Remove notice importing credentials not possible (#2418) (b80ed69)

Features

Add certificate based authentication for smtp client (#2351) (7200037)
Add ID to the recovery error when already logged in (#2483) (29e4a51)
Add localName to smtp config (#2445) (27336b6), closes #2425
Add render-schema script (a0c006e)
Add session renew capabilities (#2146) (4348b86), closes #615
Add support for netID provider (#2394) (ee7fc79)
Add tracing to persister (391c54e)
identity: Add admin and public metadata fields (562e340), closes #2388 #47:

This patch adds two new keys to identities, metadata_public and metadata_admin that can be used to store additional metadata about identities in Ory.
Read subject id from https://graph.microsoft.com/v1.0/me for microsoft (#2347) (852f24f):

Adds the ability to read the OIDC subject ID from the https://graph.microsoft.com/v1.0/me endpoint. This introduces a new field subject_source to the OIDC configuration.

Closes ory#2153
sdk: Add cookie headers to all form submissions (#2467) (9a969fd), closes #2003 #2454
sdk: Add csrf cookie for login flow submission (#2454) (2bffee8)
Support argon2i password (#2395) (8fdadf9)
Switch to opentelemetry tracing (#2318) (121a4d3)
tracing: Improved tracing for requests (#2475) (b90a558)
Upgrade to Go 1.18 (725d202)

Tests

Fix incorrect assertion (b5b1361)
Resolve regressions (dd44593)

Unclassified

BREAKING CHANGES: This patch group updates the tracing provider from OpenTracing to OpenTelemetry. Due to these changes, tracing providers Zipkin, DataDog, Elastic APM have been deactivated temporarily. The best way to re-add support for them is to make a pull request at https://github.com/ory/x/tree/master/otelx and check the status of ory/x#499 (7165fa0):

The configuration has not changed, and thus no changes to your system are required if you use Jaeger.

0.9.0-alpha.3 (2022-03-25)

Resolves an issue in the quickstart.

Breaking Changes

Calling /self-service/recovery without flow ID or with an invalid flow ID while authenticated will now respond with an error instead of redirecting to the default page.

Closes https://github.com/ory-corp/cloud/issues/2173

Co-authored-by: aeneasr 3372410+aeneasr@users.noreply.github.com

Bug Fixes

Accept recovery link from authenticated users (#2195) (0fa64dd):

When a recovery link is opened while the user already has a session cookie (possibly for another account), the endpoint will now correctly complete the recovery process and issue new cookies.
Quickstart (73b461c):

Closes ory#2339
Resolve issue where CF cookies would mingle with CSRF detection in API flows (011219a)
Typo in error message (#2332) (b075a5b)
Update v0.9.0-alpha.2 config schema path (#2328) (55705c7)
version schema: Require version or fall back to latest (52c9824)

Code Generation

Pin v0.9.0-alpha.3 release commit (32e36d4)

Documentation

Add missing error codes (b854bb8)
Clarify 410 error for api payloads (2c7ac3b)

0.9.0-alpha.2 (2022-03-22)

Resolves an issue in the SDK release pipeline.

Bug Fixes

Swag location (5b51bfb)

Code Generation

Pin v0.9.0-alpha.2 release commit (f5501cf)

0.9.0-alpha.1 (2022-03-21)

Ory Kratos v0.9 is here! We're extremely happy to announce that the new release is out and once again it's been made even better thanks to the incredible contributions from our awesome community. <3

Enjoy!

Here's an overview of things you can expect from the v0.9 release:

We introduced 1:1 compatibility between self-hosting Ory Kratos and using Ory Cloud. The configuration works the same across all modes of operation and deployment!
Passwordless login with WebAuthn is now available! Authentication with YubiKeys, TouchID, FaceID, Microsoft Hello, and other WebAuthn-supported methods is now available. The refactored infrastructure lays a foundation for more passwordless flows to come.
All the docs are now available in a single repo. Go to the ory/docs repository to find docs for all Ory projects.
You can now load custom email templates that'll make your essential messaging like project invitations or password recovery emails look slick.
We've laid the foundation for adding SMS-dependant flows.
Security is always a top priority. We've made changes and updates such as CSP nonces, SSRF defenses, session invalidation hooks, and more.
Kratos now gracefully handles cookie errors.
Password policies are now configurable.
Added configuration to control the flow of webhooks. Now you can cancel flows & run them in the background.
You can import identities along with their credentials (password, social sign-in connections, WebAuthn, ...).
Infra: we migrated all of our CIs from CircleCI to GitHub Actions.
We moved the admin API from / to admin. This is a breaking change. Please read the explanation and proceed with caution!
Bugfix: fixed a bug in the handling of secrets. This is a breaking change. Please read the explanation and proceed with caution!
Bugfix: several bugs in different self-service flows are no more.

As you can see, this release introduces breaking changes. We tried to keep the HTTP API as backward-compatible as possible by introducing HTTP redirects and other measures, but this update requires you to take extra care. Make sure you've read the release notes and understand the risk before updating.

You must apply SQL migrations for this release. Make sure to create backup before you start!

Breaking Changes

Configuration key selfservice.whitelisted_return_urls has been renamed to allowed_return_urls.

All endpoints at the Admin API are now exposed at /admin/. For example, endpoint https://kratos:4434/identities is now exposed at https://kratos:4434/admin/identities. This change makes it easier to configure reverse proxies and API Gateways. Additionally, it introduces 1:1 compatibility between Ory Cloud's APIs and self-hosted Ory Kratos. Please note that nothing has changed in terms of the port. To make the migration less painful, we have set up redirects from the old endpoints to the new /admin endpoints, so your APIs, SDKs, and clients should continue working as they were working before. This change is marked as a breaking change as it touches many endpoints and might be confusing when encountering the redirect for the first time.

If you are using two or more secrets for the secrets.session, this patch might break existing Ory Session Cookies. This has the effect that users will need to re-authenticate when visiting your app.

The password_identifier form field of the password login strategy has been renamed to identifier to make compatibility with passwordless flows possible. Field name password_identifier will still be accepted. Please note that the UI node for displaying the "username" / "email" field has this name="identifier" going forward. Additionally, the traits of the password strategy are no longer within group password but instead in group profile going forward!

The following OpenID Connect configuration keys have been renamed to better explain their purpose:

- private_key_id
+ apple_private_key_id

- private_key
+ apple_private_key

- team_id
+ apple_team_id

- tenant
+ microsoft_tenant

A major issue has been lingering in the configuration for a while. What happens to your identities when you update a schema? The answer was, it depends on the change. If the change is incompatible, some things might break!

To resolve this problem we changed the way you define schemas. Instead of having a global default_schema_url which developers used to update their schema, you now need to define the default_schema_id which must reference schema ID in your config. To update your existing configuration, check out the patch example below:

identity:
-  default_schema_url: file://stub/identity.schema.json
+  default_schema_id: default
+  schemas:
+  - id: default
+    url: file://stub/identity.schema.json

Ideally, you would version your schema and update the default_schema_id with every change to the new version:

identity:
  default_schema_id: user_v1
  schemas:
    - id: user_v0
      url: file://path/to/user_v0.json
    - id: user_v1
      url: file://path/to/user_v1.json

Bug Fixes

Add CourierConfig to default registry (#2243) (2e1fba3)
Add DispatchMessage to interface (df2ca7a)
Add missing enum (#2223) (4b7d7d0):

Closes ory/sdk#147
Add output-dir input to cli-next (#2230) (1eb3f18)
Added malformed config test (5a3c9c1)
Appropriately pass context around (#2241) (668f6b2):

Closes ory/network#56
Base redirect URL decoding (acdefa7)
Base64 encode identity schema URLs (ad44e4d):

Previously, identity schema IDs with special characters could lead to broken URLs. This patch introduces a change where identity schema IDs are base64 encoded to address this issue. Schema IDs that are not base64 encoded will continue working.
Broken links API spec (e1e7516)
Cloud config issue (135b29c)
Correct recovery hook (c7682a8)
courier: Improve composability (d47150e)
Do not error when HIBP behaves unexpectedly (#2251) (a431c1e), closes #2145
Do not remove all credentials when remove all security keys (#2233) (ecd715a)
Don't inherit flow type in recovery and verification flows (#2250) (c5b444a), closes #2049
embed: Disallow additional props (b2018ce)
embed: Do not require plaintext/html in email config (dfe4140)
Ensure no internal networks can be called in SMS sender (65e42e5)
identity: Slow query performance on MySQL (731b3c7), closes #2278
Improve password error resilience on settings flow (e614f6e)
Improve soundness of credential identifier normalization (e475163)
Incorrect makefile rule (#2222) (83a0ce7)
login: Put passwordless login before password (df9245f)
lookup: Resolve credentials counting regression (50782c6)
Lower-case jsonnet context for sms (8c58e94)
Mark struct as used (33f3dfe)
Mark width and height as required (#2322) (37f2f22):

Closes ory/sdk#157
Move to new post-release steps (#2206) (10778fd)
Mr comment fix (96c917e)
oidc: Improve empty credential handling (124d4ce)
oidc: Incorrect error handling (c8d789c)
Order regression (2cb5d2b)
Pass context to registration flow (c8d55b3)
Pass docs output dir as a separate argument (78c69a2)
Pass token to render-version-schema (#2246) (4d117e5)
password: Schema regressions (271d5fa)
Properly check for not found (77ac199)
Properly pass context (#2300) (fab8a93)
Provide access to root path and error page (#2317) (f360ee8)
Rebase regressions (d1c5085)
registration: Order for passwordless webauthn (8427322)
Remove non-hermetic sprig functions (#2201) (17e0acc):

Closes ory#2087
Resolve issues with the CI pipeline (d15bd90)
Resolve merge regression (d8ca4f3)
Resolve prettier issues (32bf052)
Resolve remaining passwordless regressions (151c8cf)
Resovle lint errors (afb7aaf)
Return 400 instead of 404 on admin recovery (ae2509c), closes #1664
sdk: Add all available discriminators (5d70f9c), closes #2287 #2288
sdk: Add webauth and lookup_secret to identityCredentialsType (#2276) (61ce3c0)
sdk: Correct minimum page to 1 (a28362e), closes #2286
selfservice: Cannot login after remove security keys and all other 2FA settings (#2181) (5ff6773), closes #2180
selfservice: Login self service flow with TOTP does not pass on return_to URL (#2175) (3eaa88e), closes #2172
session: Correctly calculate aal for passwordless webauthn (c7eb970)
session: Properly declare session secrets (6312afd), closes #2272:

Previously, a misconfiguration of Gorilla's session store caused incorrect handling of the configured secrets. From now on, cookies will also be properly encrypted at all times.
Snapshot regression (6481441)
Static analysis (a1d3254)
test: Parallelization issues (dbcf3fb)
text: Incorrect IDs for different messages (0833321), closes #2277
totp: Resolve credentials counting regression (737bb3f)
Typo (fbc8b4f)
Typo (3bb0d41)
Unstable ordering (bee26c6)
Unstable webauthn order (6262160)
Updated oathkeeper+kratos example (#2273) (567a3d7)
URL with hash sign in after_verification_return_to stays encoded (#2173) (fb1cb8a), closes #2068
Use actions/checkout for ui repos (f0136ca)
Use correct dir for clidoc (8c8a1ab)
Use HTTP 303 instead of 302 for selfservice redirects (#2215) (50b6bd8), closes #1969
Use latest hydra version (ffb3f20)
webauthn: Resolve missing identifier bug (93a1ae4)
webauthn: Schema regressions (970e861)
webauth: SPA regressions for login (be378ff)
Yq version (41b6f18)

Code Generation

Pin v0.9.0-alpha.1 release commit (72bd2ed)

Code Refactoring

All admin endpoints are now exposed under /admin/ on the admin port (8acb4cf)
Distinguish between first and multi factor credentials (8de9d01)
Identity.default_schema_url is now identity.default_schema_id (#1964) (e4f205d)
identity: Move credentials counter (c9875a7)
Mimic credentials config on import (c3eb7ce)
Move credential configs for oidc and password (50ac851)
Move docs to ory/docs (57151da)
oidc: Credentials counting (b75a639)
password: DRY up registration helpers (8a51839)
password: Internals and deprecated fields (a7784bd)
Rename password_identifier field to identifier (4dbe0ea)
Rename whitelisted_return_urls to allowed_return_urls (#2299) (686c9ba)
session: Aal computation (a136de9)
Update apple and microsoft config key names (#2261) (6da2370), closes #1979

Documentation

Add debug tip (#2186) (a1ada22)
Add react example code (#2185) (0689cc7)
Cloud (8d1d65d)
Fix broken links (d88c56f)
Fix broken links API doc (#2296) (47eaae5)
Fix versions (7186ff3)
Replace all mentions of Ory Kratos SDK with Ory SDK (#2187) (4e6897f)
Update readme (e7d9da1)

Features

Abandon courier messages after configurable timeout (#2257) (bff92f7)
Add webauthn to list of identifiers (1a8b256):

This patch adds the key webauthn to the list of possible identifiers in the Identity JSON Schema. Use this key to specify what field is used to find the WebAuthn credentials on passwordless login flows.
Add credential migrator pattern (77afc6f)
Add message for missing webauthn credentials (303dc6b)
Add new messages (09e6fd1)
Add npm install step (3d253e5)
Add versioning and improve compatibility for credential migrations (78ce668)
Added sms sending support to courier (687eca2)
Allow empty version string (419f94b)
Cancelable web hooks (44a5323):

Introduces the ability to cancel web hooks by calling error "cancel" in JsonNet.
config: Add option to mark webauthn as passwordless-able (0455e3f):

Adds option passwordless to selfservice.methods.webauthn.config, making it possible to use WebAuthn for first-factor authentication, or so-called "passwordless" authentication.
Courier template configs (#2156) (799b6a8), closes #2054:

It is now possible to override individual courier email templates using the configuration system!
courier: Expose setters again (598dc3a)
e2e: Add passwordless flows and fix bugs (ef3871b)
identity: Add identity credentials helpers (b7be327)
identity: Add versioning to credentials (aaf779a)
Ignore web hook response (ae87914):

Introduces the ability to ignore responses from web hooks in favor of faster and non-blocking execution.
Make sensitive log value redaction text configurable (#2321) (9b66e43)
oidc: Customizable base redirect uri (fa1f234):

Closes https://github.com/ory-corp/cloud/issues/2003
Password, social sign, verified email in import (41a27b1), closes #605:

This patch introduces the ability to import passwords (cleartext, PKBDF2, Argon2, BCrypt) and Social Sign In connections when creating identities!
recovery: Allow invalidation of existing sessions (5029884), closes #1077:

You can now use the revoke_active_sessions hook in the recovery flow. It invalidates all of an identity's sessions on successful account recovery.
schema: Add functionality to disallow internal HTTP requests (6e08416):

See https://github.com/ory-corp/cloud/issues/1261
security: Add e2e tests for various private network SSRF defenses (b049bc3)
security: Add SSRF defenses in OIDC (d37dc5d)
session: Add webauthn to extension validation (049fd8e)
session: Webauthn can now be a first factor as well (861bee0)
Trace web hook calls (#2154) (98ee300)
webauthn: Add error preventing deleting last webauthn credential (1209eda)
webauthn: Add new decoder schemas (c3e1501)
webauthn: Add passwordless credentials indicator (6e3057a)
webauthn: Add swagger type (14c2b74)
webauthn: Count passwordless credentials (145af23)
webauthn: Implement refresh using webauth (bf10868), closes #2284:

This change introduces the ability to refresh a session (for example when entering "sudo" mode") using WebAuthn credentials. In this case, it does not matter whether the WebAuthN credentials are for MFA or passwordless flows.
webauthn: Improve schema (790dcf3)
webauthn: Manage webauthn passwordless keys (5a62ced)
webauthn: Passwordless login (b4c4fd2)
webauthn: Update messages and nodes (22534d8)
webauthn: Use plain bytes for wrapped user (97c8c9e)

Tests

Add data for new migration (b0488ef)
Add tests for new sms options (799fa10)
cmd: Fix regressions (4b92be9)
driver: Fix regressions (c6f5137)
e2e: Add import tests (ed90f39)
e2e: Reenable hydra (055a491)
e2e: Resolve privileged regression (f7dd5ab)
e2e: Resolve regression (b5053c9)
e2e: Resolve regressions (da154c5)
e2e: Resolve regressions (d46d435)
e2e: Resolve regressions and flakes (a607385)
e2e: Wait for initial network requests (#2242) (c5a04b5)
Extract common registration helpers to library (5c1f11b)
Fix concurrent database access (46f6fb7)
Fix regression (f96e48f)
identity: Ensure migrations run when fetching identities (322d467)
identity: Fix regressions (f492f0e)
Re-enable MySQL (cbe8f6e)
Remove obsolete test (cd644ae)
Remove obsolete test failure (f8fd480)
Remove only (87b3bce)
Remove unnecessary test (2fa33e4)
Resolve potential panic (d44af28)
schema: Resolve regressions (c6d0810)
Significantly reduce persister run time (647d6ef)
Update fixtures (21462b7)
Update fixtures (299c6e3)
webauthn: Add passwordless profile (88199ea)
webauthn: Passwordless registration (c9b6280)

Unclassified

Move login hinting to own package (1eb2604)

0.8.3-alpha.1.pre.0 (2022-01-21)

autogen: pin v0.8.3-alpha.1.pre.0 release commit

Breaking Changes

This patch removes the ability to use domain aliases, an obscure feature rarely used that had several issues and inconsistencies.

Bug Fixes

Add identity_id index to identity_verifiable_addresses table (#2147) (86fd942):

The verifiable addresses are loaded eagerly into the identity. When that happens, the identity_verifiable_addresses table is queried by nid and identity_id. This index should greatly improve performance, especially of the /sessions/whoami endpoint.
Add ability to resume continuity sessions from several cookies (#2131) (8b87bdb), closes #2016 #1786
Add hiring notice to README (#2074) (0c1e816)
Add missing version tag in quickstart.yml (#2110) (1d281ea)
Adjust scan configuration (#2140) (8506fcf), closes #2083
Admin endpoint /schemas not redirecting to public endpoint (#2133) (413833f), closes #2084
Choose correct CSRF cookie when multiple are set (633076b), closes ory/kratos#2121 ory-corp/cloud#1786:

Resolves an issue where, when multiple CSRF cookies are set, a random one would be used to verify the CSRF token. Now, regardless of how many conflicting CSRF cookies exist, if one of them is valid, the request will pass and clean up the cookie store.
continuity: Properly reset cookies that became invalid (8e4b4fb), closes #2121 ory-corp/cloud#1786:

Resolves several reports related to incorrect handling of invalid continuity issues.
continuity: Remove cookie on any error (428ac03)
Do not send session after registration without hook (#2094) (3044229), closes #2093
Docker-compose standalone definition (3c7065a)
Explain mitigations in cookie error messages (ef4b01a)
Expose network wrapper (a570607)
Faq (#2101) (311f906):

This patch
- moves the FAQ to the Debug & Help section
- renames it to Tips & Troubleshooting
- moves many of the questions to documents where they fit better, reformatted and with added information where needed.
- also some other spelling/format fixes
See also ory/docusaurus-template#87
Ignore whitespace around identifier with password strategy (#2160) (45335c5), closes #2158
Improve courier test signature (b8888e3)
Include missing type string in config schema (#2142) (ec2c88a):

Inside the config.schema.json under the CORS setting, add the missing type (string) for the items of the allowed_origins array
login: Error handling when failed to prepare for an expired flow (#2120) (fdad834)
Minor fixes in FAQ update (#2130) (b53eec7)
Quickstart standalone service definition (#2149) (872b06e)
Resolve configx regression (672c0ff)
selfservice: Recovery self service flow passes on return_to URL (#1920) (b925d35), closes #914
Send 404 instead of null response for unknown verification flows (#2102) (c9490c8), closes #2099:

Fixes the verification handler to write the error, instead of nil object, when the flow does not exist. Adds tests for every handler to check proper behavior in that regard.
Support setting complex configs from the environment (c45bf83):

Closes ory#1535 Closes ory#1792 Closes ory#1801
Update download urls according to the new names (#2078) (86ae016)

Code Generation

Pin v0.8.3-alpha.1.pre.0 release commit (b1f1da2)

Code Refactoring

Deprecate domain aliases (894a2cc)

Documentation

Fix incorrect port (c9a3587), closes #2095
Fix link (c245ed4):

Closes ory/kratos-selfservice-ui-node#164
Ory cloud mentions + spelling (#2100) (0c2fa5b)
Pagination (#2143) (0807a03), closes #2039
Typo (#2073) (e1a54f9)
Typo (#2114) (a7a16d7)
Update docker guide (072ca4d), closes #2086
Upgrade guide (#2132) (4a4ab05):

Closes ory#2104

Features

Add preset CSP nonce (#2096) (8913292):

Closes ory/kratos-selfservice-ui-node#162
Added phone number identifier (#1938) (294dfa8), closes #137
Allow registration to be disabled (#2081) (864b00d), closes #882
Courier templates fs support (#2164) (13689a7)
courier: Override default link base URL (cc99096):

Added a new configuration value selfservice.methods.link.config.base_url which allows to change the default base URL of recovery and verification links. This is useful when the email should send a link which does not match the globally configured base URL.

See https://github.com/ory-corp/cloud/issues/1766
docker: Add jaeger (27ec2b7)
Enable Buildkit (#2079) (f40df5c):

Looks like this was attempted before but the magic comment was not on the first line.
Expose courier template load (#2082) (790716e)
Generalise courier tests (#2125) (75c6053)
Make the password policy more configurable (#2118) (70c627b), closes #970
security: Add option to disallow private IP ranges in webhooks (05f1e5a), closes #2152
Selfservice and administrative session management (#2011) (0fe4155), closes #655 #2007

Tests

Update cypress (#2090) (883a1b1)

0.8.2-alpha.1 (2021-12-17)

This release addresses further important security updates in the base Docker Images. We also resolved all issues related to ARM support on both Linux and macOS and fixed a bug that prevent the binary from compiling on FreeBSD.

This release also makes use of our new build architecture which means that the Docker Images names have changed. We removed the "scratch" images as we received frequent complaints about them. Additionally, all Docker Images have now, per default, SQLite support built-in. If you are relying on the SQLite images, update your Docker Pull commands as follows:

- docker pull oryd/kratos:{version}-sqlite
+ docker pull oryd/kratos:{version}

Additionally, all passwords now have to be at least 8 characters long, following recommendations from Microsoft and others.

In v0.8.1-alpha.1 we failed to include all the exciting things that landed, so we'll cover them now!

Advanced E-Mail templating support with sprig - makes it possible to translate emails as well!
Support wildcards for allowing redirection targets.
Account Recovery initiated by the Admin API now works even if identities have no email address.

Enjoy this release!

Bug Fixes

Add missing sample app paths to oathkeeper config (#2058) (a527db4):

Add "welcome,registration,login,verification" and "**.png" to the paths oathkeeper forwards to self service ui.
Add section on webauthn constraints (#2072) (23663b5)
After release hooks (56c2e61)
Dockerfile clean up (52420cc), closes #2070
Goreleaser after hook (c763f2b)
Goreleaser config (7099af2):

See goreleaser/goreleaser#2762
Release hook (90bd769)

Code Generation

Pin v0.8.2-alpha.1 release commit (627f4a1)

Documentation

Fix bodged release (032b23a)
Quickstart update (#2060) (3387cf6), closes #2032 #1916

0.8.1-alpha.1 (2021-12-13)

This maintenance release important security updates for the base Docker Images (e.g. Alpine). Additionally, several hiccups with the new ARM support have been resolved and the binaries are now downloadable for all major platforms. Please note that passwords now have to be at least 8 characters long, following recommendations from Microsoft and others.

Enjoy this release!

Bug Fixes

Bodget docs commit (f9d2f82)
Build docs on release (2cf137a)
De-duplicate message IDs (#1973) (9d8e197)
Docs links (#2008) (8515e17)
Require minimum length of 8 characters password (#2009) (bb5846e):

Kratos follows NIST Digital Identity Guidelines - 5.1.1.2 Memorized Secret Verifiers and password policy says

Passwords must have a minimum length of 8 characters and all characters (unicode, ASCII) must be allowed.
Resolve freebsd build issue (#2004) (9c75fe9), closes #1645
Revert tag (f1d7b9e), closes #1945
Set dockerfile (c860b99)
Skip docs publishing for pre releases (eb6d8cd)
Support complex lifespans (#2050) (0edbebe)
Update docs after release (850be90)
Verification error code (#1967) (44411ab), closes #1956

Code Generation

Pin v0.8.1-alpha.1 release commit (8247416)

Documentation

Add Content-Type to recommended CORS allowed headers (#2015) (dd890ab)
debug: Fix typo (#1976) (0647554)
Fix incorrect tag (bbd2355), closes #2032 #2028
Fixed date format example (#2038) (fc4703a)
Improve text around bcrypt (#2037) (ba6981e)
Levenshtein-Distance has been released (#2040) (393b6b3)
Minor fixes (#2010) (12918db)
Password-strength meter has been dropped (#2041) (9848fb3)
This has been done (#2045) (7e8c91a)
Totp unlink image in 2fa docs (#1957) (7afb731)
Update email template docs (#1960) (#1968) (b0f25a9)
Webhooks have landed (#2035) (80e53eb)

Features

Add alpine dockerfile (587eaee)
Add x-total-count to paginated pages (b633ec3)
Buildkit with multi stage build (#2025) (57ab7f7)
cmd: Add OIDC credential include (#2017) (1482844):

With this change, the kratos identities get CLI can additionally fetch OIDC credentials.
Generalise courier (#2019) (1762a73)
oidc: Add spotify provider (#2024) (0064e35)

Tests

Add web hook test cases (#2051) (316e940)
e2e: Split e2e script into setup and test phase (#2027) (1761418)
Fix changed message ID (#2013) (0bb66de)

0.8.0-alpha.4.pre.0 (2021-11-09)

autogen: pin v0.8.0-alpha.4.pre.0 release commit

Breaking Changes

To celebrate this change, we cleaned up the ways you install Ory software, and will roll this out to all other projects soon:

There is now one central brew / bash curl repository:

-brew install ory/kratos/kratos
+brew install ory/tap/kratos

-bash <(curl https://raw.githubusercontent.com/ory/kratos/master/install.sh)
+bash <(curl https://raw.githubusercontent.com/ory/meta/master/install.sh) kratos

Bug Fixes

Add base64 to ReadSchema (#1918) (8c8815b), closes #1529
Add error.id to invalid cookie/token settings flow (#1919) (73610d4), closes #1888
Adds missing webauthn authentication method (#1914) (44892f3)
Allow use of relative URLs in config (#1754) (5f73bb0), closes #1446
Do not use csrf for meta endpoints (#1927) (fd14798)
E2e test regression (#1937) (c9be009)
Include text label for link email field (07a1dbb), closes #1909
Panic on webhook with nil body (#1890) (4bf1825), closes #1885
Paths (8c852c7)
Speed up git clone (d3e4bde)
Update sdk orb (94e12e6)
Use bcrypt for password hashing in example (a9196f2)
Use new ory installation method (09cfc7e)

Code Generation

Pin v0.8.0-alpha.4.pre.0 release commit (3e443b7)

Documentation

Add subdomain configuration in csrf page (#1896) (681750f):

Add some instructions as to how kratos can be configured to work across subdomains.
Remove unintended characters in subdomain section in csrf page (#1897) (dfb9007)

Features

Add new goreleaser build chain (#1932) (cf1714d):

This patch adds full compatibility with ARM architectures, including Apple Silicon (M1). We additionally added cryptographically signed signatures verifiable using cosign for both binaries as well as docker images.
Add quickstart mimicking hosted ui (813fb4c)
Advanced e-mail templating support (#1859) (54b97b4), closes #834 #925
Allow wildcard domains for redirect_to checks (#1528) (349cdcf), closes #943:

Support wildcard domains in redirect_to checks.
Configurable health endpoints access logging (#1934) (1301f68):

This PR introduces a new boolean configuration parameter that allows turning off logging of health endpoints requests in the access log. The implementation is basically a rip-off from Ory Hydra and the configuration parameter is the same:
```
serve.public.request_log.disable_for_health
serve.admin.request_log.disable_for_health
```
The default value is false.
Integrate sbom generation to goreleaser (#1850) (305bb28)
Make admin recovery to work without emails #1419 (#1750) (db00e85)

Tests

e2e: Improved SDK set up and arm fix (#1933) (c914ba1)
Update snapshots (a820653)

0.8.0-alpha.3 (2021-10-28)

Resolves issues in the quickstart.

Bug Fixes

Resolve quickstart issues (#1900) (d047009):

Closes ory#1899

Code Generation

Pin v0.8.0-alpha.3 release commit (a307deb)

0.8.0-alpha.2 (2021-10-28)

Resolves an issue in the SDK release pipeline.

Code Generation

Pin v0.8.0-alpha.2 release commit (2178929)

0.8.0-alpha.1 (2021-10-27)

We are extremely excited to share this next generation of Ory Kratos! The project is truly maturing and the community is getting larger by the hour.

On this special occasion, we would like to bring to your attention that the Ory Summit is happening tomorrow and on Friday! You will hear gripping talks from the Ory Community and Ory maintainers! And the best part, tickets are free and we are covering multiple time zones!

This release is truly the best version of Ory Kratos to date and we want to give you a tl;dr of the 345 commits and 1152 files changed, and what you can expect from this release:

Full multi-factor authentication with different enforcement policies (soft/hard MFA).
Support for WebAuthn (FIDO2 / U2F) two-factor authentication - from fingerprints to hardware tokens every FIDO2 device is supported!
Ability to fetch the initial OAuth2 Access and Refresh and OpenID Connect ID Tokens an identity receives when performing social sign up. Optionally, these tokens are stored encrypted in the database (XChaCha20Poly1305 or AES-GCM)!
Support for TOTP (Google Authenticator) two-factor verification/authentication.
Advanced two-factor recovery with lookup secrets.
A complete reference implementation of the Ory Kratos end-user (self-service) facing UI in ReactJS & VercelJS.
"Native" support for Single-Page App Single Sign-On.
Much improved single-page app and native app APIs for all self-service flows.
Support for PKBDF2 password hashing, which will help import user passwords from other systems in the future.
Bugfixes and improvements to the OpenAPI spec and auto-generated SDKs.
ARM Docker Images.
Greatly improved internal e2e test pipeline using Cypress 8.x.
Improved functional tests with cupaloy snapshot testing.
Documentation on different error codes and message identifiers to easier translate messages in your own UI.
Better form decoding and ability to mark required JSON Schema fields as required in the UI.
Bug fixes that could result in users ending up in irrecoverable UI states.
Better support for return_to across flows (e.g. OIDC) and in custom UIs.
SBOM Software Supply Chain scanning & reporting.
Docker Image vulnerability checking as part of the release pipeline.
Support sending emails via AWS SES SMTP.
A REST endpoint to invalidate all an identity's sessions.

As you can see, much has happened and we are grateful for all the great interactions we have with you, every day!

Let's take a look at some of the breaking changes. Even though much was added, little has changed in breaking ways! This is a testament that Ory Kratos' internals and APIs are becoming more stable!

This release requires you to run SQL migrations. Please, as always, create a backup of your database first!

The SDKs are now generated with tag v0alpha2 to reflect that some signatures have changed in a breaking fashion. Please update your imports from v0alpha1 to v0alpha2.

The SMTPS scheme used in courier config URL with cleartext/StartTLS/TLS SMTP connection types is now only supporting implicit TLS. For StartTLS and cleartext SMTP, please use the SMTP scheme instead.

Example:

SMTP Cleartext: smtp://foo:bar@my-mailserver:1234/?disable_starttls=true
SMTP with StartTLS: smtps://foo:bar@my-mailserver:1234/ -> smtp://foo:bar@my-mailserver:1234/
SMTP with implicit TLS: smtps://foo:bar@my-mailserver:1234/?legacy_ssl=true -> `smtps://foo:bar@my-mailserver:1234/We are extremely excited to share this next generation of Ory Kratos! The project is truly maturing and the community is getting larger by the hour.

On this special occasion, we would like to bring to your attention that the Ory Summit is happening tomorrow and on Friday! You will hear gripping talks from the Ory Community and Ory maintainers! And the best part, tickets are free and we are covering multiple time zones!

This release is truly the best version of Ory Kratos to date and we want to give you a tl;dr of the 345 commits and 1152 files changed, and what you can expect from this release:

Full multi-factor authentication with different enforcement policies (soft/hard MFA).
Support for WebAuthn (FIDO2 / U2F) two-factor authentication - from fingerprints to hardware tokens every FIDO2 device is supported!
Ability to fetch the initial OAuth2 Access and Refresh and OpenID Connect ID Tokens an identity receives when performing social sign up. Optionally, these tokens are stored encrypted in the database (XChaCha20Poly1305 or AES-GCM)!
Support for TOTP (Google Authenticator) two-factor verification/authentication.
Advanced two-factor recovery with lookup secrets.
A complete reference implementation of the Ory Kratos end-user (self-service) facing UI in ReactJS & VercelJS.
"Native" support for Single-Page App Single Sign-On.
Much improved single-page app and native app APIs for all self-service flows.
Support for PKBDF2 password hashing, which will help import user passwords from other systems in the future.
Bugfixes and improvements to the OpenAPI spec and auto-generated SDKs.
ARM Docker Images.
Greatly improved internal e2e test pipeline using Cypress 8.x.
Improved functional tests with cupaloy snapshot testing.
Documentation on different error codes and message identifiers to easier translate messages in your own UI.
Better form decoding and ability to mark required JSON Schema fields as required in the UI.
Bug fixes that could result in users ending up in irrecoverable UI states.
Better support for return_to across flows (e.g. OIDC) and in custom UIs.
SBOM Software Supply Chain scanning & reporting.
Docker Image vulnerability checking as part of the release pipeline.
Support sending emails via AWS SES SMTP.
A REST endpoint to invalidate all an identity's sessions.

As you can see, much has happened and we are grateful for all the great interactions we have with you, every day!

Let's take a look at some of the breaking changes. Even though much was added, little has changed in breaking ways! This is a testament that Ory Kratos' internals and APIs are becoming more stable!

This release requires you to run SQL migrations. Please, as always, create a backup of your database first!

The SDKs are now generated with tag v0alpha2 to reflect that some signatures have changed in a breaking fashion. Please update your imports from v0alpha1 to v0alpha2.

The SMTPS scheme used in courier config URL with cleartext/StartTLS/TLS SMTP connection types is now only supporting implicit TLS. For StartTLS and cleartext SMTP, please use the SMTP scheme instead.

Example:

SMTP Cleartext: smtp://foo:bar@my-mailserver:1234/?disable_starttls=true
SMTP with StartTLS: smtps://foo:bar@my-mailserver:1234/ -> smtp://foo:bar@my-mailserver:1234/
SMTP with implicit TLS: smtps://foo:bar@my-mailserver:1234/?legacy_ssl=true -> `smtps://foo:bar@my-mailserver:1234/We are extremely excited to share this next generation of Ory Kratos! The project is truly maturing and the community is getting larger by the hour.

On this special occasion, we would like to bring to your attention that the Ory Summit is happening tomorrow and on Friday! You will hear gripping talks from the Ory Community and Ory maintainers! And the best part, tickets are free and we are covering multiple time zones!

This release is truly the best version of Ory Kratos to date and we want to give you a tl;dr of the 345 commits and 1152 files changed, and what you can expect from this release:

Full multi-factor authentication with different enforcement policies (soft/hard MFA).
Support for WebAuthn (FIDO2 / U2F) two-factor authentication - from fingerprints to hardware tokens every FIDO2 device is supported!
Ability to fetch the initial OAuth2 Access and Refresh and OpenID Connect ID Tokens an identity receives when performing social sign up. Optionally, these tokens are stored encrypted in the database (XChaCha20Poly1305 or AES-GCM)!
Support for TOTP (Google Authenticator) two-factor verification/authentication.
Advanced two-factor recovery with lookup secrets.
A complete reference implementation of the Ory Kratos end-user (self-service) facing UI in ReactJS & VercelJS.
"Native" support for Single-Page App Single Sign-On.
Much improved single-page app and native app APIs for all self-service flows.
Support for PKBDF2 password hashing, which will help import user passwords from other systems in the future.
Bugfixes and improvements to the OpenAPI spec and auto-generated SDKs.
ARM Docker Images.
Greatly improved internal e2e test pipeline using Cypress 8.x.
Improved functional tests with cupaloy snapshot testing.
Documentation on different error codes and message identifiers to easier translate messages in your own UI.
Better form decoding and ability to mark required JSON Schema fields as required in the UI.
Bug fixes that could result in users ending up in irrecoverable UI states.
Better support for return_to across flows (e.g. OIDC) and in custom UIs.
SBOM Software Supply Chain scanning & reporting.
Docker Image vulnerability checking as part of the release pipeline.
Support sending emails via AWS SES SMTP.
A REST endpoint to invalidate all an identity's sessions.

As you can see, much has happened and we are grateful for all the great interactions we have with you, every day!

Let's take a look at some of the breaking changes. Even though much was added, little has changed in breaking ways! This is a testament that Ory Kratos' internals and APIs are becoming more stable!

This release requires you to run SQL migrations. Please, as always, create a backup of your database first!

The SDKs are now generated with tag v0alpha2 to reflect that some signatures have changed in a breaking fashion. Please update your imports from v0alpha1 to v0alpha2.

The SMTPS scheme used in courier config URL with cleartext/StartTLS/TLS SMTP connection types is now only supporting implicit TLS. For StartTLS and cleartext SMTP, please use the SMTP scheme instead.

Example:

SMTP Cleartext: smtp://foo:bar@my-mailserver:1234/?disable_starttls=true
SMTP with StartTLS: smtps://foo:bar@my-mailserver:1234/ -> smtp://foo:bar@my-mailserver:1234/
SMTP with implicit TLS: smtps://foo:bar@my-mailserver:1234/?legacy_ssl=true -> smtps://foo:bar@my-mailserver:1234/

Breaking Changes

The location of the homebrew tap has changed from ory/ory/kratos to ory/tap/kratos.

To stay consistent with other query parameter's, the self-service login flow's forced key has been renamed to refresh.

The SDKs are now generated with tag v0alpha2 to reflect that some signatures have changed in a breaking fashion. Please update your imports from v0alpha1 to v0alpha2.

To support 2FA on non-browser (e.g. native mobile) apps we have added the Ory Session Token as a possible parameter to both initializeSelfServiceLoginFlowWithoutBrowser and submitSelfServiceLoginFlow. Depending on the SDK generator, the order of the arguments may have changed. In JavaScript:

- .submitSelfServiceLoginFlow(flow.id, payload)
+ .submitSelfServiceLoginFlow(flow.id, sessionToken, payload)
+ // or if the user has no session yet:
+ .submitSelfServiceLoginFlow(flow.id, undefined, payload)

To improve the overall API design we have changed the result of POST /self-service/settings. Instead of having flow be a key, the flow is now the response. The updated identity payload stays the same!

 {
-  "flow": {
-    "id": "flow-id-..."
-    ...
-  },
+  "id": "flow-id-..."
+  ...
   "identity": {
     "id": "identity-id-..."
   }
 }

The SMTPS scheme used in courier config url with cleartext/StartTLS/TLS SMTP connection types is now only supporting implicit TLS. For StartTLS and cleartext SMTP, please use the smtp scheme instead.

Example:

SMTP Cleartext: smtp://foo:bar@my-mailserver:1234/?disable_starttls=true
SMTP with StartTLS: smtps://foo:bar@my-mailserver:1234/ -> smtp://foo:bar@my-mailserver:1234/
SMTP with implicit TLS: smtps://foo:bar@my-mailserver:1234/?legacy_ssl=true -> smtps://foo:bar@my-mailserver:1234/

This patch changes the naming and number of prometheus metrics (see: ory/x#379). In short: all metrics will have now http_ prefix to conform to Prometheus best practices.

Bug Fixes

Add error id (1442784)
Add mfa e2e test scenarios and resolve found issues (436992d)
Add middleware earlier #1775 (#1776) (b9d253e)
Allow refresh and aal upgrade at the same time (2ec801f)
API client leaks stack trace with an error (#1772) (d3aff6d), closes #1771
Better const handling for internal context (1e457e3)
Correct swagger path for /identities/:id/session endpoint (#1756) (d614f2a)
Decoder regression in registration (febf75a)
Deterministic clidoc dates (e48d90a)
Disable totp per default (7278589)
Docs autogen should not use time.Now (a830f5b)
Ensure correct error propagation (77ce709)
Ensure refresh issues a new session when the identity changes (a10b385)
Ensure return_to works for OIDC flows (d615734), closes #1773
Explicit validation for return to in new flows (284cf29)
Follow chrome webauthn best practice recommendation (0a7c812)
Githup-app name in config (#1822) (1b50963)
Handle return errors on the frontend and break early (0e8d481):

Closes https://github.com/ory-corp/cloud/issues/1426
Identity credential identifiers are now unique per method (57fd99a)
Improve schema validation error tracing (f793fe5)
Incorrect JSON response for browser flows (1501f56)
Kill modd as well (e5a98e5)
link: Resolve incorrect response types when opening API recovery link in browser (35ea8db)
login: Properly handle refresh (8dc7059)
lookup: Ensure correct fields are set (5ed4c55)
lookup: Resolve reuse scenarios (dbfe475)
lookup: Set up codes correctly (2f373f3)
OIDC provider field in spec (#1809) (11b25de)
oidc: Ensure nested keys work on login (71583c5)
Omitempty for VerifiedAt and StateChangedAt (#1736) (bf2ec6e):

Closes ory/sdk#95
Only respect required modules for SDK (4c5677f)
Panic when recovering deactivated user (0a49f27), closes #1794 #1826
Potentially resolve hanging postgres connection closing (693a928)
Properly encode aal error (49b6288)
Properly open recovery endpoints in browser if flow was initiated via API (23c12e5)
Remove duplicate schema error (4e69123)
Remove initial_value again as it was not useful outside of booleans (0cc984b)
Remove obsolete openapi patch (11618ec)
Remove unnecessary cmd reference (351760e)
Replace 302 with 303 (2e2b0f8)
Resolve clidoc generation issue (1aaaa03)
Resolve merge issues (1dc7497)
Resolve openapi issues and regenerate clients (f7d60c0)
Resolve swagger regression (02b9d47)
Run format on ts files (f55f6f6)
Slow CLI start-up time (ae20c17):

Found a deeply nested dependency which was importing https://github.com/markbates/pkger, causing unreasonable CPU consumption and significant delay at start up time. With this patch, start up time was reduced from almost 3s to ~0.01s.
```
$ time kratos
kratos  2.55s user 2.46s system 508% cpu 0.986 total

$ time ./kratos-patch
./kratos-patch  0.00s user 0.00s system 64% cpu 0.001 total
```
test: OIDC storategy test (#1836) (b877dbe)
totp: Reorder QR (d096df7)
Try and reduce cookie flakyness (e7ae8d6)
Typo (8c4d8a2)
ui: Use correct type for anchor (a6595e4)
Update schema config location (539ae73)
Use parallelism of 1 in go test (8736334)
webauthn: Support react-based webauth (b6123b4)
X-session-token must not be mandatory (05d73be)

Code Generation

Pin v0.8.0-alpha.1 release commit (c2c902c)

Code Refactoring

courier: Support SMTP schemes for implicit TLS, explicit StartTLS, and cleartext SMTP (#1831) (4cb082c), closes #1770 #1769
Homogenize error messages (421a319)
Improved prometheus metrics (#1830) (0be993b), closes #1735:

This will add new prometheus metrics for Kratos that are more useful for alerting and increase overall observability.
Login flow forced renamed to refresh (92087e5)
login: Rename forced -> refresh (8d1e54b)
login: Support 2FA for non-browser SDKs (df4846d)
Move expired error into top-level flow module (01a2602)
Move homebrew tap to ory/tap (0ee67c3)
Move node identifiers to node package (b0a86dc)
Revert decision to return 422 errors and streamline 401/403 (8aa5318)
Sdk API is no v0alpha2 (3f06738)
session: CreateAndIssueCookie is now UpsertAndIssueCookie (a6d134d)
session: CreateSession is now UpsertSession (3ec81a2)
settings: Change settings success response (12f98f2)

Documentation

Add 2fa credentials (f7899a7)
Add 2fa guide (b4eed76)
Add a commandline example for the logout (#1753) (81ba264)
Add admin ui guide (ac88060)
Add advanced custom UI documentation (5e3a2cd)
Add image assets (6bc93ca)
Add missing angle bracket (#1799) (4270140)
Add ory sessions as a concept (626c0c9)
Add powershell to deps (#1853) (e945336), closes #1848
credentials: Add AAL explanation (c1f501e)
Enhance error return values (3799c24)
Fix invalid syntax (#1819) (8cd6428)
Fix the flow links used for rendering (#1752) (131d2c2)
Fix the invalid links (#1868) (6d621ec)
Remove obsolete file (b7f9052)
Update generated docs (72afb81)
Update quickstart curl examples (#1778) (6c677c4)
Use correct link (f007919), closes #1793

Features

Add intended_for_someone_else error code (572a131)
Add aal fallback for existing sessions (a5c7b11)
Add authenticators after set up (035c276)
Add DeleteCredentialsType to identity struct including tests (b12bf52)
Add e2e tests for react native 2fa (a3ac253)
Add error ids for csrf-related errors (dc2adbf)
Add error ids for redirect-related errors (246a045)
Add error ids for session-related errors (087d907)
Add explicit return_to to flow objects and API parameters (50d04ea), closes #1605 #1121:

This patch adds a return_to field to the flow objects which contains the original ?return_to=... value. It uses the Flow's request_url for that purpose.
Add ids for user-facing errors for login, registration, settings (787558b):

This patch adds a new field id to JSON error payloads. This helps tremendously in implementing better client-side (native / SPA) apps as the API now returns error IDs like no_active_session, orbidden_return_to, no_verified_address and more. UIs can use these IDs to decide what to do next in the application - for example redirecting to a particular endpoint or showing an error message.
Add initial value to bool checkboxes (63dba73)
Add internal context to login and registration (723e6ee)
Add internal context to settings flow (afb6895)
Add lookup node to disable lookup (d0836be):

See ory/network#12
Add lookup to config (14119b6)
Add lookup to identity (ead3833)
Add lookup to migrations (dac4f75)
Add MFA enforcment option to whoami and settings (554d725)
Add mfa for non-browser (4096fd3)
Add missing migrations (ccc64d8)
Add option to disable recovery codes (9d3daa6):

Closes ory/network#12
Add ory cli config (5b959be)
Add schema patch for new initial_value field (131e380):

The field sets a node input's initial value. This is primarily used for fields which are e.g. checkboxes or buttons (active/inactive). If this field is set on a button, it implies that clicking the button should trigger the "value" to be set.
Add script type and discriminator for attributes (de0af95):

See ory/sdk#72
Add smtp headers config option (#1747) (7ffe0e9), closes #1725
Add support for onclick javascript in ui nodes (7cc7efa)
Add totp strategy for settings flow (d1d6617):

This patch allows adding a TOTP device in the settings, and also removing it when no longer needed.
Add webauthn identity credential (f8b9582)
Adding Dockle Container Linter (#1852) (3c0d519)
Adjust to new aal error handling (b8956bc)
API to return access, refresh, id tokens from social sign in (#1818) (198991a), closes #1518 #397:

This patch introduces the new include_credential query parameter to the GET /identities endpoint which allows administrators to receive the initial access, refresh, and ID tokens from Social Sign In (OpenID Connect / OAuth 2.0) flows.

These tokens can be stored in an encrypted format (XChaCha20Poly1305 or AES-GCM) in the database if an appropriate encryption secret is set. To get started easily these values are not encrypted per default.

For more information head over to the docs.
Auto-generate list of messages (cf46339), closes #1784
Endpoint to list all identity schemas (#1703) (aa23d5d), closes #1699
Generate sdks and update versions (c9d22d9)
hash: PBKDF2 password hash verification (#1774) (33cc7e0), closes #1659
Identity schema validation on startup (#1779) (99db3f0), closes #701
identity: Add AAL constants (882573d)
Implement AAL for login and sessions (45467e0)
Implement endpoint for invalidating all sessions for a given identity (#1740) (dbd1689), closes #655:

This PR introduces endpoint to destroy all sessions for a given identity which effectively logouts user from all devices/sessions. This is useful when for some security concern we want to make sure there are no "old" sessions active or other "staff" related actions (such as force logout after password change etc.).
Implement lookup code settings and login (8f3ce7b)
Improve detection of AAL errors and return 422 instead of 403 (e2bfbea)
Improve labels for totp and lookup (b92e00e)
Improve session device annotations (87907b8)
In docker debug support with delve (#1789) (37325a1)
Introduce cve scanning (#1798) (ade13ea)
logout: Add logout token to browser response (#1758) (d3f1177)
Mark recovery email address verified (#1665) (e3efc5d), closes #1662
Mark required fiels as required (34cd5e8):

Closes https://github.com/ory-corp/cloud/issues/1328 Closes ory#400 Closes ory#1058 See https://ory-community.slack.com/archives/C012RJ2MQ1H/p1631825476159000
Natively support social sign in for single-page apps (1a1a350)
persistence: Add new columns for mfa (6184fe3)
Potentially add arm64 docker support (68112de)
Proper enum and type assertions for openapi (c4d8516)
Publish webauthn as loadable script instead of eval (2717c59)
Redirect on login if session aal is not matched (8feff8d)
Respect webauthn in session aal (869b4a5)
session: Respect 2fa enforcement in whoami (3a82c88)
Sign in with apple (#1833) (16ed123), closes #1782:

Adds an adapter and configuration options for enabling Social Sign In with Apple.
Sort totp nodes (5c9a494)
Stubable time in text package (22e4ed1)
Support apple m1 (54b4fb6)
Support setting the identity state via the admin API (#1805) (29c060b), closes #1767
Support strategy return to ui for settings (74670bb)
Support webauthn for mfa (e8f4d3c)
totp: Add width and height to QR code (a648ba3)
totp: Support account name setting from schema (19a6bcc)
Treat lookup as aal2 in session (3269028)
Use discriminators for ui node types in spec (59e808e)
Use initial_value in lookup strategy (efe272f)

Reverts

3745014 (d493d10)

Tests

Aal in login.NewFlow (5986e38)
AcceptToRedirectOrJSON (2ca153f)
Add credentials test (58b388c)
Add expired test to login handler (3bdb8ab)
Add identity change test to settings submit (5eb090b)
Add initial spa e2e test (20617f6)
Add initial totp integration tests (c9d456b)
Add login tests (a71cadd)
Add migrations tests for new tables (3c96ab0)
Add react app to e2e tests (1214eee)
Add schema test for totp config (c4f05ba)
Add session amr test (eedb60b)
Add settings tests (6959565)
Add test for TOTPIssuer (14731c4)
Add test for ui error page (3977a9c)
Add TestEnsureInternalContext (152bfc7)
Add totp registry tests (817e3ec)
Add totp settings tests (c5a0d0f)
Add TOTP to profile (7431e9f)
Add update session test (47bd057)
Additional checks for flow hydration (a40d7fe)
Amr persistence (b0b2d81)
Check if internal context is validated in store (a23d851)
CheckAAL (03b37e7)
Complete TOTP login integration tests (6e503cf)
e2e: Add baseurl (159b25f)
e2e: Add checkboxes to schemas (0c91f0c)
e2e: Add config for proxy to simplify cy.visit logic (7d87985)
e2e: Add mfa profile (a60d157)
e2e: Add modd to build (48cd8ae)
e2e: Add more helpers and ts defs (21b35b0)
e2e: Add more helpers for various flows and proxy settings (755ac60)
e2e: Add more routes to registry (30423c9)
e2e: Add more typings for cypress helpers (60bd63f)
e2e: Add plugin for using got (8fafc40)
e2e: Add proxy capabilities for react native app (b5668df)
e2e: Add recovery tests for SPA (b6014ee)
e2e: Add spa as allowed redirect url (2625d16)
e2e: Add SPA tests for login and refactor tests to typescript (d9a25df)
e2e: Add SPA tests for logout and refactor tests to typescript (b0c6776)
e2e: Add SPA tests for registration and refactor tests to typescript (a61ed1e)
e2e: Add support functions and type definitions (c82d68d)
e2e: Clean up helper (4806add)
e2e: Complete SPA tests for all mfa flows (2196129)
e2e: Default and empty values and required fields (72f2c5f)
e2e: Ensure advanced types work in forms also (287269c)
e2e: Ensure correct app (a9ff545)
e2e: Finalize mobile tests (acf5c3d)
e2e: Force port (a49eda8)
e2e: Homogenize profiles (7798e19)
e2e: Hot reload ory kratos on changes (841da09)
e2e: Implement recovery tests for SPA (3dea57f)
e2e: Implement required verification tests for SPA (fb55f34)
e2e: Improve stability for login tests (43df22b)
e2e: Improve stability for registration tests (a1c59a3)
e2e: Improve test reliability (061a7e3)
e2e: Migrate email tests to new proxy set up (54d8cd6)
e2e: Migrate settings tests to typescript and add SPA tests (566336d)
e2e: Move config to lower level and publish as package (c21fa26)
e2e: Move registration tests to new proxy set up (eddeb85)
e2e: Port mobile test to typescript (db42346)
e2e: Port remaining e2e tests to typescript (5853d1a)
e2e: Potentially resolve flaky login test (e237d66)
e2e: Potentially resolve webauthn startup issues (eae6f5d)
e2e: Prototype typescript implementation (2e869cf)
e2e: Recreate identities per flow (1a560a3)
e2e: Reduce flaky tests (cae86e7)
e2e: Reduce test flakes in lookup codes (bfea354)
e2e: Refactor and add support for SPA app (7609219)
e2e: Remove wait condition (af10b03)
e2e: Resolve broken test (c7cf134)
e2e: Resolve flaky test (de7cc59)
e2e: Resolve flaky test issues (1627745)
e2e: Resolve next not starting (2a2a3cb)
e2e: Resolve regression (d62f0c0)
e2e: Resolve regressions (aaff34e)
e2e: Resolve regressions (af9aedc)
e2e: Revert proxy changes (293d920)
e2e: Stabilize e2e tests (a5dca28)
e2e: Temporarily add totp to default profile (8ffac9d)
e2e: Update e2e profiles to new proxy set up (a3204cf)
e2e: Use 127.0.0.1 to prevent ipv6 issues (6f4b534)
e2e: Wait for oidc to trigger (9c67c49)
Enable cookie debug (81c3064)
Ensure aal and amr is set on recovery (5cbab54), closes #1322
Ensure aal2 can not be used for oidc (cbbcdd2)
Ensure aal2 can not be used for password (d9d39f0)
Ensure authenticated_at after all upgrade (80408b4)
Ensure redirect_url in password strategy (9eafc10)
ErrStrategyAsksToReturnToUI behavior (f739018)
Finalize webauthn tests (97e59e6)
Fix regressions in the tests (246c580)
Fix tests in cmd/serve (#1755) (b704d08)
ID methods of node attributes (ff9ff04)
Login form submission with AAL (4d54fbb)
lookup: Add secret_disable to snapshots (68d6a87)
lookup: Ensure context is cleaned up after use (8a210c4)
lookup: Refresh and reuse scenarios (89736ed)
migration: Resolve mysql migration issue with empty array (71a5649)
Move to cupaloy for snapshots (0cce70f)
Properly refresh mobile session (c31915d)
Registry regression (25c88b5)
Remove todo items (f60050e)
Resolve flaky config test (147c670)
Resolve flaky config test (#1832) (db98d01)
Resolve flaky example tests (#1817) (0e700d8)
Resolve flaky tests (2bd9100)
Resolve migratest regressions (e9a1ed1)
Resolve regressions (1502ca1)
Resolve regressions (1a93b2f)
Resolve regressions (64850ed)
Resolve remaining regressions (f02804c)
Resolve remaining regressions (0224c22)
Resolve remaining regressions (1fa2aa5)
Resolve time locality issues (53b8b2a)
Restructure session struct tests (50d3f66)
Session AAL handling (6fea3e5)
Session activate (c86fa03)
sql: Fix incorrect UUID (ea2894e)
Temporarily enable lookup globally (458f559)
totp: Ensure context is cleaned up after use (1905883)
Upgrade cypress to 8.x (c8a1dfc)
Use different return handler (e489a43)
Various aal combinations for newflow (b095b99)
Webauth settings flow (4c82772)
Webauthn aal2 login (60ace8b)
Webauthn credentials (c3e1184)
Webauthn credentials counter (f7701f6)
webauthn: Ensure context is cleaned up after use (7a8055b)

Unclassified

test(e2e) improve reliability (763dd00)
Correct session godoc (7108e65)

0.7.6-alpha.1 (2021-09-12)

Resolves further issues in the SDK and release pipeline.

Code Generation

Pin v0.7.6-alpha.1 release commit (8b0d1ee)

0.7.5-alpha.1 (2021-09-11)

Primarily resolves issues in the SDK pipeline.

Code Generation

Pin v0.7.5-alpha.1 release commit (3a741a5)

0.7.4-alpha.1 (2021-09-09)

This release adds the GitHub-app provider, improves SQL instrumentation, resolves an expired flow bug, and resolves documentation issues.

Bug Fixes

Corret sdk annotations for enums (6152363)
Do not panic if cookiemanager returns a nil cookie (6ea5678), closes #1695
Respect return_to in expired flows (#1697) (394a8de), closes #1251

Code Generation

Pin v0.7.4-alpha.1 release commit (67ff8a9)

Documentation

Add e2e quickstart (2b749d3)
Browser redirects (#1700) (a44089a)
Mark logout_url always available (9021805)
Minor improvements (#1707) (79c132c)

Features

Making use of the updated instrumentedsql version (#1723) (9e6fbdd)
oidc: Github-app provider (#1711) (fb1fe8c)

Tests

session: Resolve incorrect assertion (0531220)

0.7.3-alpha.1 (2021-08-28)

This patch resolves a regression issue with Facebook login, a memory leak issue introduced by an external dependency, adds a "requires verification" login hook, and improves performance for some endpoints.

Also, Ory Kratos SDKs are now published in individual GitHub repositories for every language.

Bug Fixes

Add new message when refresh parameter is true (#1560) (0525623), closes #1117
Add session in spa registration if session cook is configured (#1657) (639a7dd), closes #1604
docs: Ensure config reference is updated (f6b3aa4), closes #1597
Facebook sign in regression (#1689) (85337bf), closes #1687 #1686
Http context memory leak (b21bd22):

Ory Kratos was using gorilla/sessions prior to version v1.2 which had a dependency on gorilla/context, a deprecated library with known memory management issues. Even though we used gorilla/context's clean up middleware, it appears that r.Context() was not properly cleaned up, causing memory leaks.

On average, the memory leak is pretty small, but depending on what gets added to r.Context() it could significantly increase the memory leak.

By replacing gorilla/sessions with v1.2.1 we:
1. Increased the HTTP API throughput by an estimate of 4 times;
2. Brought average memory use back down to about 12MB;
Closes https://github.com/ory-corp/cloud/issues/1292
Outdated label (#1681) (149101e)
Register argon2 CLI commands properly (#1592) (45c28d9)
Remove session cookie on logout (#1587) (cdb30bb), closes #1584:

Before, the logout endpoint would invalidate the session cookie, but not remove it. This was a regression introduced in 0.7.0. This patch resolves that issue.
sdk: Use proper annotation for genericError (#1611) (da214b2), closes #1609
Skip prompt on discord authorization by default (#1594) (a667255):

When a value for prompt is not provided, Discord defaults to prompt="consent". This change makes it so that if the request is not forced, prompt is explicitly set to "none".
Static parameter for warning message in config.baseURL(...) (#1673) (db54a1b), closes #1672
Update csrf token cookie name (#1601) (64c90bf):

See https://github.com/ory-corp/cloud/issues/1252
Use eager preloading for list identites endpoint (#1588) (de5fb3e)

Code Generation

Pin v0.7.3-alpha.1 release commit (b5ad53e)

Documentation

Change model to schema (#1639) (09c403e)
Fix func naming for Logout flow (#1676) (bbeb613):

rename createSelfServiceLogoutUrlForBrowsers to createSelfServiceLogoutFlowUrlForBrowsers
Fix stub error example (#1642) (9bc2fd0), closes #1568
Fixes incorrect yaml identation (#1641) (6b58278)
Identity traits are visible to user (#1621) (641eba6)
Make qickstart URLs consistent (playground vs. localhost) (#1626) (bae1847):

Since the quick-start describes how to run Kratos locally the actual location of the redirect is http://127.0.0.1:4433/self-service/login/browser.
Update docker.md - Outdated information (#1627) (dc32720), closes #1619:

Kratos does not automatically use a config file that exists at $HOME/.kratos.yaml, or any other similar pattern. The documentation in the Docker Images section of the guides could lead developers to believe that the --config flag is unnecessary if they are binding the directory the configuration file is in to $HOME or using a custom docker image to provide the file.

Features

Allow multiple webhook body sources (#1606) (51b1311):

This patch adds support for loading webhooks from the local filesystem, base64 encoded inline string, and remote (http/https) sources. Please note that support for relative/absolute paths without an URI scheme are deprecated and will eventually be removed.
Require verified address (#1355) (1cf61cd), closes #1328

0.7.1-alpha.1 (2021-07-22)

This release addresses regressions introduced in Ory Kratos v0.7.0 and resolves some bugs and documentation inconsistencies.

Bug Fixes

Automatic tagging for node ui (fe5056e), closes #1537
Bump kratos ui image for quickstart (aedbb5a), closes #1537
Cleanup lint errors and add doc to x (#1545) (3cfd784)
Correct meta schema (8d4f3ff)
Do not reset link method (#1573) (835fb31)
Do not set csrf cookies on /sessions/whoami (#1580) (36bbd43)
Export extensionschemas (#1553) (6af7638)
Generate CSRF token on validation creation (#1549) (6612c5f), closes #1547
Identity extension meta schema (#1554) (ba5ca64):

Up until now the extension meta schema was only applied to top level keys. This fix now recursively checks the extension schema on any depth.
Remove domain alias config constraint (#1542) (c6145db)
Resolve wrong openapi types (b07927c)
Update identity state openapi spec (0217737)
Use legacy ssl in quickstart config (6c13c2b), closes #1569

Code Generation

Pin v0.7.1-alpha.1 release commit (4fe76af)

Documentation

Add instruction for creating user (#1541) (c2a1b6d), closes #1530
Clarify flags in schema which are not available in config file (e5ea5fe), closes #1514
Fix formatting of Email and Phone Verification Flow tab content (#1536) (0bfac67)
Fix typo (#1543) (b25bae7)
Fix typo (#1544) (547788d)
Update csrf pitfall flow section (#1558) (cc7ed4b), closes #1557

Tests

Longer wait time for e2e boot (3a85a33)

0.7.0-alpha.1 (2021-07-13)

About two months ago we released Ory Kratos v0.6. Today, we are excited to announce the next iteration of Ory Kratos v0.7! This release includes 215 commits from 24 contributors with over 770 files and more than 100.000 lines of code changed!

Ory Kratos v0.7 brings massive developer experience improvements:

A reworked, tested, and standardized SDK based on OpenAPI 3.0.3 (#1477, #1424);
Native support of Single-Page-Apps (ReactJS, AngularJS, ...) for all self-service flows (#1367);
Sign in with Yandex, VK, Auth0, Slack;
An all-new, secure logout flow (#1433);
Important security updates to the self-service GET APIs (#1458, #1282);
Built-in support for TLS (#1466);
Improved documentation and Go Module structure;
Resolving a case-sensitivity bug in self-service recovery and verification flows;
Improved performance for listing identities;
Support for Instant tracing (#1429);
Improved control for SMTPS, supporting SSL and STARTTLS (#1430);
Ability to run Ory Kratos in networks without outbound requests (#1445);
Improved control over HTTP Cookie behavior (#1531);
Several smaller user experience improvements and bug fixes;
Improved e2e test pipeline.

In the next iteration of Ory Kratos, we will focus on providing a NextJS example application for the SPA integration as well as the long-awaited MFA flows!

Please be aware that upgrading to Ory Kratos 0.7 requires you to apply SQL migrations. Make sure to back up your database before migration!

For more details on breaking changes and patch notes, see below.

Breaking Changes

Prior to this change it was not possible to specify the verification/recovery link lifetime. Instead, it was bound to the flow expiry. This patch changes that and adds the ability to configure the lifespan of the link individually:

 selfservice:
   methods:
     link:
       enabled: true
       config:
+        # Defines how long a recovery link is valid for (default 1h)
+        lifespan: 15m

This is a breaking change because the link strategy no longer respects the recovery / verification flow expiry time and, unless set, will default to one hour.

This change introduces a better SDK. As part of this change, several breaking changes with regards to the SDK have been introduced. We recommend reading this section carefully to understand the changes and how they might affect you.

Before, the SDK was structured into tags public and admin. This stems from the fact that we have two ports in Ory Kratos - one administrative and one public port.

While serves as a good overview when working with Ory Kratos, it does not express:

What module the API belongs to (e.g. self-service, identity, ...)
What maturity the API has (e.g. experimental, alpha, beta, ...)
What version the API has (e.g. v0alpha0, v1beta0, ...)

This patch replaces the current admin and public tags with a versioned approach indicating the maturity of the API used. For example, initializeSelfServiceSettingsForBrowsers would no longer be under the public tag but instead under the v0alpha1 tag:

import {
  Configuration,
- PublicApi
+ V0Alpha1
} from '@ory/kratos-client';

- const kratos = new PublicApi(new Configuration({ basePath: config.kratos.public }));
+ const kratos = new V0Alpha1(new Configuration({ basePath: config.kratos.public }));

To avoid confusion when setting up the SDK, and potentially using the wrong endpoints in your codebase and ending up with strange 404 errors, Ory Kratos now redirects you to the correct port, given that serve.(public|admin).base_url are configured correctly. This is a significant improvement towards a more robust API experience!

Further, all administrative functions require, in the Ory SaaS, authorization using e.g. an Ory Personal Access Token. In the open source, we do not know what developers use to protect their APIs. As such, we believe that it is ok to have admin and public functions under one common API and differentiate with an admin prefix. Therefore, the following patches should be made in your codebase:

import {
- AdminApi,
+ V0Alpha1,
  Configuration
} from '@ory/kratos-client';

-const kratos = new AdminApi(new Configuration({ basePath: config.kratos.admin }));
+const kratos = new V0Alpha1(new Configuration({ basePath: config.kratos.admin }));

-kratos.createIdentity({
+kratos.adminCreateIdentity({
  schema_id: 'default',
  traits: { /* ... */ }
})

Further, we have introduced a style guide for writing SDKs annotations governing how naming conventions should be chosen.

We also streamlined how credentials are used. We now differentiate between:

Per-request credentials such as the Ory Session Token / Cookie

- public getSelfServiceRegistrationFlow(id: string, cookie?: string, options?: any) {}
+ public getSelfServiceSettingsFlow(id: string, xSessionToken?: string, cookie?: string, options?: any) {}

Global credentials such as the Ory (SaaS) Personal Access Token.

const kratos = new V0Alpha0(
  new Configuration({
    basePath: config.kratos.admin,
    accessToken: "some-token",
  }),
)

kratosAdmin.adminCreateIdentity({
  schema_id: "default",
  traits: {
    /* ... */
  },
})

This patch introduces CSRF countermeasures for fetching all self-service flows. This ensures that users can not accidentally leak sensitive information when copy/pasting e.g. login URLs (see #1282). If a self-service flow for browsers is requested, the CSRF cookie must be included in the call, regardless if it is a client-side browser app or a server-side browser app calling. This does not apply for API-based flows.

As part of this change, the following endpoints have been removed:

GET <ory-kratos-admin>/self-service/login/flows;
GET <ory-kratos-admin>/self-service/registration/flows;
GET <ory-kratos-admin>/self-service/verification/flows;
GET <ory-kratos-admin>/self-service/recovery/flows;
GET <ory-kratos-admin>/self-service/settings/flows.

Please ensure that your server-side applications use the public port (e.g. GET <ory-kratos-public>/self-service/login/flows) for fetching self-service flows going forward.

If you use the SDKs, upgrading is easy by adding the cookie header when fetching the flows. This is only required when using browser flows on the server side.

The following example illustrates a ExpressJS (NodeJS) server-side application fetching the self-service flows.

app.get('some-route', (req: Request, res: Response) => {
-   kratos.getSelfServiceLoginFlow(flow).then((flow) => /* ... */ )
+   kratos.getSelfServiceLoginFlow(flow, req.header('cookie')).then((flow) => /* ... */ )

-   kratos.getSelfServiceRecoveryFlow(flow).then((flow) => /* ... */ )
+   kratos.getSelfServiceRecoveryFlow(flow, req.header('cookie')).then((flow) => /* ... */ )

-   kratos.getSelfServiceRegistrationFlow(flow).then((flow) => /* ... */ )
+   kratos.getSelfServiceRegistrationFlow(flow, req.header('cookie')).then((flow) => /* ... */ )

-   kratos.getSelfServiceVerificationFlow(flow).then((flow) => /* ... */ )
+   kratos.getSelfServiceVerificationFlow(flow, req.header('cookie')).then((flow) => /* ... */ )

-   kratos.getSelfServiceSettingsFlow(flow).then((flow) => /* ... */ )
+   kratos.getSelfServiceSettingsFlow(flow, undefined, req.header('cookie')).then((flow) => /* ... */ )
})

For concrete details, check out the changes in the NodeJS app.

This patch refactors the logout functionality for browsers and APIs. It adds increased security and DoS-defenses to the logout flow.

Previously, calling GET /self-service/browser/flows/logout would remove the session cookie and redirect the user to the logout endpoint. Now you have to make a call to GET /self-service/logout/browser which returns a JSON response including a logout_url URL to be used for logout. The call to /self-service/logout/browser must be made using AJAX with cookies enabled or by including the Ory Session Cookie in the X-Session-Cookie HTTP Header. You may also use the SDK method createSelfServiceLogoutUrlForBrowsers to do that.

Additionally, the endpoint DELETE /sessions has been moved to DELETE /self-service/logout/api. Payloads and responses stay equal. The SDK method revokeSession has been renamed to submitSelfServiceLogoutFlowWithoutBrowser.

We listened to your feedback and have improved the naming of the SDK method initializeSelfServiceRecoveryForNativeApps to better match what it does: initializeSelfServiceRecoveryWithoutBrowser. As in the previous release you may still use the old SDK if you do not want to deal with the SDK breaking changes for now.

We listened to your feedback and have improved the naming of the SDK method initializeSelfServiceVerificationForNativeApps to better match what it does: initializeSelfServiceVerificationWithoutBrowser. As in the previous release you may still use the old SDK if you do not want to deal with the SDK breaking changes for now.

We listened to your feedback and have improved the naming of the SDK method initializeSelfServiceSettingsForNativeApps to better match what it does: initializeSelfServiceSettingsWithoutBrowser. As in the previous release you may still use the old SDK if you do not want to deal with the SDK breaking changes for now.

We listened to your feedback and have improved the naming of the SDK method initializeSelfServiceregistrationForNativeApps to better match what it does: initializeSelfServiceregistrationWithoutBrowser. As in the previous release you may still use the old SDK if you do not want to deal with the SDK breaking changes for now.

We listened to your feedback and have improved the naming of the SDK method initializeSelfServiceLoginForNativeApps to better match what it does: initializeSelfServiceLoginWithoutBrowser. As in the previous release you may still use the old SDK if you do not want to deal with the SDK breaking changes for now.

Bug Fixes

Add json detection to setting error subbranches (fb83dcb)
Add verification success message (#1526) (126698c), closes #1450
Cache migration status (5be2f14), closes #1337
Change SMTP config validation from URI to a Regex pattern (#1436) (5ab1e8f), closes #1435
Check filesystem before fallback to bundled templates (#1401) (22d999e)
Continue button for oidc registration step (2aad5ac), closes #1422 #1320:

When signing up with an OIDC provider and the traits model is missing some fields, the submit button shows all OIDC options. Instead, it should show just one option called "Continue".
Deprecate sessionCookie (#1428) (eccad74), closes #1426
Do not cache incomplete migrations (#1434) (154c26f)
Do not run network migrations when booting (12bbab9), closes #1399
Format test files (0468aa1)
Improve identity list performance (f76886f), closes #1412
Incorrect openapi specification for verification submission (#1431) (ecb0a01), closes #1368
Link t docker guide (953c6d6)
Mark ui node message as optional (#1365) (7b8d59f), closes #1361 #1362
Mark verified_at as omitempty (77b258e):

Closes ory/sdk#46
Panic if contextualizer is not set (760035a)
Panic on error in issue session (5fbd855), closes #1384
Prometheus metrics fix (#1299) (ac5d00d)
Recovery email case sensitive (#1357) (bce14c4), closes #1329
Remove changelog (7affb7a)
Remove obsolete ADD for corp module (#1455) (0fa3a53)
Remove typing from node.attribute.value (63a5e08):

Closes ory/sdk#75 Closes ory/sdk#74 Closes ory/sdk#72
Rename client package for external consumption (cba8b00)
Resolve build issues on release (7c265a8)
Resolve driver issues (47b1c8d)
Resolve network regression (8f96b1f)
Resolve network regressions (8fc52c0)
Testhelper regressions (bf3b04f)
Use correct url in submitSelfServiceVerificationFlow (ab8a600)
Use local schema URL for sorting UI nodes (#1449) (a003885)
Use session cookie path settings for csrf cookie (#1493) (c6d08ed), closes #1292:

This PR adds configuration option for CSRF cookies and improves the domain alias logic as well as adding tests for it.
Use STARTTLS for smtps connections (#1430) (c21bb80), closes #781
Version schema (#1359) (8c4bac7), closes #1331 #1101 ory/hydra#2427

Code Generation

Pin v0.7.0-alpha.1 release commit (53a0e38)

Code Refactoring

Corp package (#1402) (0202dc5)
Finalize SDK refactoring (e772641), closes kratos#1424 #1424
Identity SDKs (d8658dc), closes #1477
Improve session sdk (7207af4)
Introduce DefaultContextualizer in corp package (#1390) (944d045), closes #1363
Move cleansql to separate package (7c203dc)
Openapi.json -> api.json (6df0de5)
Self-service error APIs (65c482f)

Documentation

Add docs for registration SPA flow (84458f1)
Add go sdk examples (e948fad)
Add kratos quickstart config notes (#1490) (2f8094c)
Add replit instructions (8ab8607)
Add tested and running go sdk examples (3b56bb5)
Correct CII badge (#1447) (048aec3)
Fix broken link (9eaf764)
Fix building from source (#1473) (af54d5b)
Fix typo in "Sign in/up with ID & assword" (#1383) (f39739d)
Mark login endpoints as experimental (6faf0f6)
Refactor documentation and adopt changes for #1477 (f5e96cd), closes #1472
Remove changelog from docs folder (5a7e3d8)
Resolve build issues (b51bb55)
Resolve typos and docs react issues (2d640e4)
Update docs for all flows (d29ea69)
Update documentation for plaintext templates (#1369) (419784d), closes #1351
Update error documentation (7d83609)
Update login flow documentation (a27de91)
Update path (f0384d9)
Update README.md Go instructions (#1464) (8db4b4a)
Update remaining self service documentation (bcc6284)
Update sdk use (bcb8c06)
Update settings documentation (258ceaf)
Use correct path (#1333) (e401135)

Features

Add examples for usage of go sdk (870c2bd)
Add GetContextualizer (ac32717)
Add helper for starting kratos e2e (#1469) (b9c7674)
Add instana as possible tracing provider (#1429) (abe48a9), closes #1385
Add redoc (#1502) (492266d)
Add vk and yandex providers to oidc providers and documentation (#1339) (22a3ef9), closes #1234
Anti-CSRF measures when fetching flows (#1458) (5171557), closes #1282
Configurable recovery/verification link lifetime (f80d4e3)
Disable HaveIBeenPwned validation when HaveIBeenPwnedEnabled is set to false (#1445) (44002f4), closes #316:

This patch introduces an option to disable HaveIBeenPwned checks in environments where outbound network calls are disabled.
identities: Add a state to identities (#1312) (d22954e), closes #598
Improve contextualization in serve/daemon (f83cd35)
Include Credentials Metadata in admin api (#1274) (c8b6219), closes #820
Include Credentials Metadata in admin api Missing changes in handler (#1366) (a71c220)
Natively support SPA for login flows (6ff67af), closes #1138 #668:

This patch adds the long-awaited capabilities for natively working with SPAs and AJAX requests. Previously, requests to the /self-service/login/browser endpoint would always end up in a redirect. Now, if the Accept header is set to application/json, the login flow will be returned as JSON instead. Accordingly, changes to the error and submission flow have been made to support application/json content types and SPA / AJAX requests.
Natively support SPA for recovery flows (5461244):

This patch adds the long-awaited capabilities for natively working with SPAs and AJAX requests. Previously, requests to the /self-service/recovery/browser endpoint would always end up in a redirect. Now, if the Accept header is set to application/json, the registration flow will be returned as JSON instead. Accordingly, changes to the error and submission flow have been made to support application/json content types and SPA / AJAX requests.
Natively support SPA for registration flows (57d3c57), closes #1138 #668:

This patch adds the long-awaited capabilities for natively working with SPAs and AJAX requests. Previously, requests to the /self-service/registration/browser endpoint would always end up in a redirect. Now, if the Accept header is set to application/json, the registration flow will be returned as JSON instead. Accordingly, changes to the error and submission flow have been made to support application/json content types and SPA / AJAX requests.
Natively support SPA for settings flows (ea4395e):

This patch adds the long-awaited capabilities for natively working with SPAs and AJAX requests. Previously, requests to the /self-service/settings/browser endpoint would always end up in a redirect. Now, if the Accept header is set to application/json, the registration flow will be returned as JSON instead. Accordingly, changes to the error and submission flow have been made to support application/json content types and SPA / AJAX requests.
Natively support SPA for verification flows (c151500):

This patch adds the long-awaited capabilities for natively working with SPAs and AJAX requests. Previously, requests to the /self-service/verification/browser endpoint would always end up in a redirect. Now, if the Accept header is set to application/json, the registration flow will be returned as JSON instead. Accordingly, changes to the error and submission flow have been made to support application/json content types and SPA / AJAX requests.
Protect logout against CSRF (#1433) (1a7a74c), closes #142
Sign in with Auth0 (#1352) (f618a53), closes #609
Support api in settings error (23105db)
Support reading session token from X-Session-Token HTTP header (dcaefd9)
Team id in slack oidc (#1409) (e4d021a), closes #1408
TLS support for public and admin endpoints (#1466) (7f44f81), closes #791
Update openapi specs and regenerate (cac507e)

Tests

Add tests for cookie behavior of API and browser endpoints (d1b1521)
e2e: Greatly improve test performance (#1421) (2ffad9e):

Instead of running the individual profiles as separate Cypress instances, we now use one singular instance which updates the Ory Kratos configuration depending on the test context. This ensures that hot-reloading is properly working while also signficantly reducing the amount of time spent on booting up the service dependencies.
e2e: Resolve flaky test issues related to timeouts and speed (b083791)
e2e: Resolve recovery regression (72c47d6)
e2e: Resolve test config regressions (eb9c4f9)
Remove obsolete console.log (3ecc869)
Resolve e2e regressions (b0d3b82)
Resolve migratest panic (89d05ae)
Resolve mobile regressions (868e82e)
Resolve oidc regressions (2403082)

Unclassified

add CoC shield (#1439) (826ed1a), closes #1439
u (b03549b)
u (318a31d)
Format (eca7aff)
Format (5cc9fc3)
Format (e525805)
Format (4a692ac)
Format (169c0cd)

0.6.3-alpha.1 (2021-05-17)

This release addresses some minor bugs and improves the SDK experience. Please be aware that the Ory Kratos SDK v0.6.3+ have breaking changes compared to Ory Kratos SDK v0.6.2. If you do not wish to update your code, you can keep using the Ory Kratos v0.6.2 SDK and upgrade to v0.6.3+ SDKs at a later stage, as only naming conventions have changed!

Breaking Changes

Unfortunately, some method signatures have changed in the SDKs. Below is a list of changed entries:

Error genericError was renamed to jsonError and now includes more information and better typing for errors;
The following functions have been renamed:
- initializeSelfServiceLoginViaAPIFlow -> initializeSelfServiceLoginForNativeApps
- initializeSelfServiceLoginViaBrowserFlow -> initializeSelfServiceLoginForBrowsers
- initializeSelfServiceRegistrationViaAPIFlow -> initializeSelfServiceRegistrationForNativeApps
- initializeSelfServiceRegistrationViaBrowserFlow -> initializeSelfServiceRegistrationForBrowsers
- initializeSelfServiceSettingsViaAPIFlow -> initializeSelfServiceSettingsForNativeApps
- initializeSelfServiceSettingsViaBrowserFlow -> initializeSelfServiceSettingsForBrowsers
- initializeSelfServiceRecoveryViaAPIFlow -> initializeSelfServiceRecoveryForNativeApps
- initializeSelfServiceRecoveryViaBrowserFlow -> initializeSelfServiceRecoveryForBrowsers
- initializeSelfServiceVerificationViaAPIFlow -> initializeSelfServiceVerificationForNativeApps
- initializeSelfServiceVerificationViaBrowserFlow -> initializeSelfServiceVerificationForBrowsers
Some type names have changed, for example traits -> identityTraits.

Bug Fixes

Improve settings oas definition (867abfc)
Properly handle CSRF for API flows in recovery and verification strategies (461c829), closes #1141
session: Use specific headers before bearer use (82c0b54)
Use correct api spec path (5f41f87)
Use correct openapi path for validation (#1340) (a0f5673)

Code Generation

Pin v0.6.3-alpha.1 release commit (5edf952)

Code Refactoring

Improve SDK experience (71b8511):

This patch resolves UX issues in the auto-generated SDKs by using consistent naming and introducing a test suite for the Ory SaaS.

0.6.2-alpha.1 (2021-05-14)

Resolves an issue in the Go SDK.

Code Generation

Pin v0.6.2-alpha.1 release commit (99c1b1d)

Documentation

Update link to example email template. (#1326) (28a1723)

0.6.1-alpha.1 (2021-05-11)

This release primarily addresses issues in the SDK CI pipeline.

Code Generation

Pin v0.6.1-alpha.1 release commit (1df82da)

Features

Allow changing password validation API DNS name (#1009) (ced85e8)

0.6.0-alpha.2 (2021-05-07)

This release addresses issues with the SDK pipeline and also closes a bug related to email sending.

Bug Fixes

Update node image (eef307e)

Code Generation

Pin v0.6.0-alpha.2 release commit (a3658ba)

Features

Fix unexpected emails when update profile (#1300) (7b24485), closes #1221

0.6.0-alpha.1 (2021-05-05)

Today Ory Kratos v0.6 has been released! We are extremely happy with this release where we made many changes that pave the path for exciting future additions such as integrating 2FA more easily! We would like to thank the awesome community for the many contributions.

Kratos v0.6 includes an insane amount of work spread over the last five months - 480 commits and over 4200 files changed. The team at Ory would like to thank all the amazing contributors that made this release possible!

Here is a summary of the most important changes:

Ory Kratos now support highly customizable web hooks - contributed by @dadrus and @martinei;
Ory Kratos Courier can now be run as a standalone task using kratos courier watch -c your/config.yaml. To use the mail courier as a background task of the server run kratos serve --watch-courier - contributed by @mattbonnell;
Reworked migrations to ensure stable migrations in production systems - backward compatibility is ensured and tested;
Upgraded to Go 1.16 and removed all static file packers, greatly improving build time;
Refactored our SDK pipeline from Swagger 2.0 to OpenAPI Spec 3.0. Ory's SDKs are now properly typed and bugs can easily be addressed using a patch process. Due to this, we had to move away from go-swagger client generation for the Go SDK and replace it with openapi-generator. This, unfortunately, introduced breaking changes in the Go SDK APIs. If you have problems migrating, or have a tutorial on how to migrate, please share it with the community on GitHub!
Created reliable health and status checks by ensuring that e.g. migrations have completed;
Made resilient CLI client commands e.g. kratos identities list;
Better support for cookies in multi-domain setups called domain aliasing;
A new, dynamically generated FAQ;
Enhanced GitHub and Google claims parsing;
Faster and more resilient CI/CD pipeline;
Improvements for running Ory Kratos in secure Kubernetes environments;
Better Helm Charts for Ory Kratos;
Support for BCrypt hashing, which is now the default hashing implementation. Existing Argon2id hashes will be automatically translated to BCrypt hashes when the user signs in the next time. We recommend using Argon2id in use cases where password hashing is required to take at least 2 seconds. For regular web workloads (200ms) BCrypt is recommended - contributed by @seremenko-wish;
The Argon2 memory configuration is now human readable: hashers.argon2.memory: 131072 -> hashers.argon2.memory: 131072B (supports kb, mb, kib, mib, ...).
Add possibility to keep track of the return_to URLs for verification_flows after sign up using the new after_verification_return_to query parameter (e.g. http://foo.com/registration?after_verification_return_to=verification_callback) - contributed by @mattbonnell;
Emails are now populated at delivery time, offering more flexibility in terms of templating;
Emails contain a plaintext variant for email clients that do not display HTML emails - contributed by @mattbonnell;
Mitigation for password hash timing attacks by adding a random delay to login attempts where the user does not exist;
Resolving SDKs issues for whoami requests;
Simplified database schema for faster processing, significantly reducing the amount of data stored and latency as several JOINS have been removed;
Support for binding the HTTP server on UNIX sockets - contributed by @sloonz;

There are even more contributions by @NickUfer and harnash. In total, 33 people contributed to this release! Thank you all!

IMPORTANT: Please be aware that the database schema has changed significantly. Applying migrations might, depending on the size of your tables, take a long time. If your database does not support online schema migrations, you will experience downtimes. Please test the migration process before applying it to production!

The probably biggest and most significant change is the refactoring of how self-service flows work and what their payloads look like. This took the most amount of time and introduces the biggest breaking changes in our APIs. We did this refactoring to support several flows planned for Ory Kratos 0.7:

Displaying QR codes (images) in login, registration, settings flows - necessary for TOTP 2FA;
Asking the login/registration/... UI to render JavaScript - necessary for CAPTCHA, WebAuthN, and more;
Refactoring the form submission API to use one endpoint per flow instead of one endpoint per flow per method. This allows us to process several registration/settings/login/... methods such as password + 2FA in one Go.

Check out how we migrated the NodeJS app from the Ory Kratos 0.5 to Ory Kratos 0.6 SDK.

Let's take a look into how these payloads have changed (the flows have identical configuration):

Ory Kratos v0.5

Login

{
  "id": "ee6e1565-d3c3-4f3a-a6ff-0ba6b3a6481b",
  "type": "browser",
  "expires_at": "2020-09-13T10:49:54.8295242Z",
  "issued_at": "2020-09-13T10:39:54.8295242Z",
  "request_url": "http://127.0.0.1:4433/self-service/login/browser",
  "methods": {
    "password": {
      "method": "password",
      "config": {
        "action": "http://127.0.0.1:4433/self-service/login/methods/password?flow=ee6e1565-d3c3-4f3a-a6ff-0ba6b3a6481b",
        "method": "POST",
        "fields": [
          {
            "name": "identifier",
            "type": "text",
            "required": true,
            "value": ""
          },
          {
            "name": "password",
            "type": "password",
            "required": true
          },
          {
            "name": "csrf_token",
            "type": "hidden",
            "required": true,
            "value": "lNrB8sW2fZY6xnnA91V7ISYrUVcJbmRCOoGHjsnsfI7MsIL5RTbuWFm5TRv1azQW+7IRCfnt2Ch6pC42/45sJQ=="
          }
        ]
      }
    }
  },
  "forced": false
}

Registration

{
  "id": "2b1f8c5d-e830-4068-97b8-35f776df9217",
  "type": "browser",
  "expires_at": "2020-09-13T10:53:15.1774019Z",
  "issued_at": "2020-09-13T10:43:15.1774019Z",
  "request_url": "http://127.0.0.1:4433/self-service/registration/browser",
  "active": "password",
  "messages": null,
  "methods": {
    "password": {
      "method": "password",
      "config": {
        "action": "http://127.0.0.1:4433/self-service/registration/methods/password?flow=2b1f8c5d-e830-4068-97b8-35f776df9217",
        "method": "POST",
        "fields": [
          {
            "name": "csrf_token",
            "type": "hidden",
            "required": true,
            "value": "1IlHWNjkAZxuYhO82WPgNTgujKsUSaW87j6og/20i2uM4wRTWGSSUg0dJ2fbXa8C5bfM9eTKGdauGwE7y9abwA=="
          },
          {
            "name": "password",
            "type": "password",
            "required": true,
            "messages": [
              {
                "id": 4000005,
                "text": "The password can not be used because the password has been found in at least 23597311 data breaches and must no longer be used..",
                "type": "error",
                "context": {
                  "reason": "the password has been found in at least 23597311 data breaches and must no longer be used."
                }
              }
            ]
          },
          {
            "name": "traits.email",
            "type": "text",
            "value": "foo@ory.sh"
          },
          {
            "name": "traits.name.first",
            "type": "text",
            "value": "Ory"
          },
          {
            "name": "traits.name.last",
            "type": "text",
            "value": "Corp"
          }
        ]
      }
    }
  }
}

Ory Kratos v0.6

Login

As you can see below, the input name identifier has changed to password_identifier.

{
  "id": "07016811-917d-4788-bb9c-fc297897af6c",
  "type": "browser",
  "expires_at": "2021-04-28T08:37:53.924337873Z",
  "issued_at": "2021-04-28T08:27:53.924337873Z",
  "request_url": "http://127.0.0.1:4433/self-service/login/browser",
  "ui": {
    "action": "http://127.0.0.1:4433/self-service/login?flow=07016811-917d-4788-bb9c-fc297897af6c",
    "method": "POST",
    "nodes": [
      {
        "type": "input",
        "group": "default",
        "attributes": {
          "name": "csrf_token",
          "type": "hidden",
          "value": "IuiHo8fajl6Nwi2CfR33bmC7ZI+geYY44oinK/npkS9gaeV6DlkzS0voYZuyGawsCruvlawFl/pY6/Ph6d9JVg==",
          "required": true,
          "disabled": false
        },
        "messages": null,
        "meta": {}
      },
      {
        "type": "input",
        "group": "password",
        "attributes": {
          "name": "password_identifier",
          "type": "text",
          "value": "",
          "required": true,
          "disabled": false
        },
        "messages": null,
        "meta": {
          "label": {
            "id": 1070004,
            "text": "ID",
            "type": "info"
          }
        }
      },
      {
        "type": "input",
        "group": "password",
        "attributes": {
          "name": "password",
          "type": "password",
          "required": true,
          "disabled": false
        },
        "messages": null,
        "meta": {
          "label": {
            "id": 1070001,
            "text": "Password",
            "type": "info"
          }
        }
      },
      {
        "type": "input",
        "group": "password",
        "attributes": {
          "name": "method",
          "type": "submit",
          "value": "password",
          "disabled": false
        },
        "messages": null,
        "meta": {
          "label": {
            "id": 1010001,
            "text": "Sign in",
            "type": "info",
            "context": {}
          }
        }
      }
    ]
  },
  "forced": false
}

Registration

{
  "id": "f0c0830a-f5b2-4c2d-a37f-2e70152a4f7c",
  "type": "browser",
  "expires_at": "2021-04-28T08:54:12.951178972Z",
  "issued_at": "2021-04-28T08:44:12.951178972Z",
  "request_url": "http://127.0.0.1:4433/self-service/registration/browser",
  "ui": {
    "action": "http://127.0.0.1:4433/self-service/registration?flow=f0c0830a-f5b2-4c2d-a37f-2e70152a4f7c",
    "method": "POST",
    "nodes": [
      {
        "type": "input",
        "group": "default",
        "attributes": {
          "name": "csrf_token",
          "type": "hidden",
          "value": "408SIAOvpKxW/WbcYfKue26MlLTMbON7T7JT1yhiSemhznD5yiwZuZDXKsWu9vU5BIxfrsAQ8rn10QcdOFSRkA==",
          "required": true,
          "disabled": false
        },
        "messages": null,
        "meta": {}
      },
      {
        "type": "input",
        "group": "password",
        "attributes": {
          "name": "traits.email",
          "type": "email",
          "disabled": false
        },
        "messages": null,
        "meta": {
          "label": {
            "id": 1070002,
            "text": "E-Mail",
            "type": "info"
          }
        }
      },
      {
        "type": "input",
        "group": "password",
        "attributes": {
          "name": "password",
          "type": "password",
          "required": true,
          "disabled": false
        },
        "messages": null,
        "meta": {
          "label": {
            "id": 1070001,
            "text": "Password",
            "type": "info"
          }
        }
      },
      {
        "type": "input",
        "group": "password",
        "attributes": {
          "name": "traits.name.first",
          "type": "text",
          "disabled": false
        },
        "messages": null,
        "meta": {
          "label": {
            "id": 1070002,
            "text": "First Name",
            "type": "info"
          }
        }
      },
      {
        "type": "input",
        "group": "password",
        "attributes": {
          "name": "traits.name.last",
          "type": "text",
          "disabled": false
        },
        "messages": null,
        "meta": {
          "label": {
            "id": 1070002,
            "text": "Last Name",
            "type": "info"
          }
        }
      },
      {
        "type": "input",
        "group": "password",
        "attributes": {
          "name": "method",
          "type": "submit",
          "value": "password",
          "disabled": false
        },
        "messages": null,
        "meta": {
          "label": {
            "id": 1040001,
            "text": "Sign up",
            "type": "info",
            "context": {}
          }
        }
      }
    ]
  }
}

These changes are analogous to settings, recovery, verification as well!

We hope you enjoy these new features as much as we do, even if we were not able to deliver 2FA in time for 0.6!

On the last note, Ory Platform, a SaaS is launching in May as early access. It includes Ory Kratos as a managed service and we plan on adding all the other Ory open source technology soon. In our view, Ory is a 10x improvement to the existing "IAM" ecosystem:

The major components of Ory Platform are and will remain Apache 2.0 licensed open source. We are not changing our approach or commitment to open source. The SaaS model allows us to keep commercialization and open source in harmony;
Affordable pricing - Ory does not charge on a per identity basis;
Supporting migrations from the Ory Platform (SaaS) to the open-source and vice versa;
Offering a planet-scale service with ultra-low latencies no matter where your users are;
The largest set of features and APIs of any Identity Product, including Identity and Credentials Management (Ory Kratos), Permissions and Access Control (Ory Keto), Zero-Trust Networking (Ory Oathkeeper), OAuth2, and OpenID Connect (Ory Hydra) plus integrations with Stripe, Mailchimp, Salesforce, and much more.
Data aggregation for threat mitigation, auditing, and other use cases (e.g. integration with Snowflake, AWS RedShift, GCP BigQuery, ...)
All the advantages of the open source projects - headless, fully customizable, strong security, built with a community; If you wish to become a part of the preview, please write a short email to sales@ory.sh. Early access adopters are also eligible for Ory Hypercare - helping you integrate with Ory fast and designing your security architecture following industry best practices.

Thank you for being a part of our community!

Breaking Changes

BCrypt is now the default hashing alogrithm. If you wish to continue using Argon2id please set hashers.algorithm to argon2.

This implies a significant breaking change in the verification flow payload. Please consult the new ui documentation. In essence, the login flow's methods key was replaced with a generic ui key which provides information for the UI that needs to be rendered.

To apply this patch you must apply SQL migrations. These migrations will drop the flow method table implying that all verification flows that are ongoing will become invalid. We recommend purging the flow table manually as well after this migration has been applied, if you have users doing at least one self-service flow per minute.

This implies a significant breaking change in the recovery flow payload. Please consult the new ui documentation. In essence, the login flow's methods key was replaced with a generic ui key which provides information for the UI that needs to be rendered.

To apply this patch you must apply SQL migrations. These migrations will drop the flow method table implying that all recovery flows that are ongoing will become invalid. We recommend purging the flow table manually as well after this migration has been applied, if you have users doing at least one self-service flow per minute.

This implies a significant breaking change in the settings flow payload. Please consult the new ui documentation. In essence, the login flow's methods key was replaced with a generic ui key which provides information for the UI that needs to be rendered.

To apply this patch you must apply SQL migrations. These migrations will drop the flow method table implying that all settings flows that are ongoing will become invalid. We recommend purging the flow table manually as well after this migration has been applied, if you have users doing at least one self-service flow per minute.

This implies a significant breaking change in the registration flow payload. Please consult the new ui documentation. In essence, the login flow's methods key was replaced with a generic ui key which provides information for the UI that needs to be rendered.

To apply this patch you must apply SQL migrations. These migrations will drop the flow method table implying that all registration flows that are ongoing will become invalid. We recommend purging the flow table manually as well after this migration has been applied, if you have users doing at least one self-service flow per minute.

This implies a significant breaking change in the login flow payload. Please consult the new ui documentation. In essence, the login flow's methods key was replaced with a generic ui key which provides information for the UI that needs to be rendered.

To apply this patch you must apply SQL migrations. These migrations will drop the flow method table implying that all login flows that are ongoing will become invalid. We recommend purging the flow table manually as well after this migration has been applied, if you have users doing at least one self-service flow per minute.

This change introduces a new feature: UI Nodes. Previously, all self-service flows (login, registration, ...) included form fields (e.g. methods.password.config.fields). However, these form fields lacked support for other types of UI elements such as links (for e.g. "Sign in with Google"), images (e.g. QR codes), javascript (e.g. WebAuthn), or text (e.g. recovery codes). With this patch, these new features have been introduced. Please be aware that this introduces significant breaking changes which you will need to adopt to in your UI. Please refer to the most recent documentation to see what has changed. Conceptionally, most things stayed the same - you do however need to update how you access and render the form fields.

Please be also aware that this patch includes SQL migrations which purge existing self-service forms from the database. This means that users will need to re-start the login/registration/... flow after the SQL migrations have been applied! If you wish to keep these records, make a back up of your database prior!

This change introduces a new feature: UI Nodes. Previously, all self-service flows (login, registration, ...) included form fields (e.g. methods.password.config.fields). However, these form fields lacked support for other types of UI elements such as links (for e.g. "Sign in with Google"), images (e.g. QR codes), javascript (e.g. WebAuthn), or text (e.g. recovery codes). With this patch, these new features have been introduced. Please be aware that this introduces significant breaking changes which you will need to adopt to in your UI. Please refer to the most recent documentation to see what has changed. Conceptionally, most things stayed the same - you do however need to update how you access and render the form fields.

Please be also aware that this patch includes SQL migrations which purge existing self-service forms from the database. This means that users will need to re-start the login/registration/... flow after the SQL migrations have been applied! If you wish to keep these records, make a back up of your database prior!

The configuration value for hashers.argon2.memory is now a string representation of the memory amount including the unit of measurement. To convert the value divide your current setting (KB) by 1024 to get a result in MB or 1048576 to get a result in GB. Example: 131072 would now become 128MB.

Co-authored-by: aeneasr 3372410+aeneasr@users.noreply.github.com Co-authored-by: aeneasr aeneas@ory.sh

Please run SQL migrations when applying this patch.

The following configuration keys were updated:

selfservice.methods.password.config.max_breaches

password.max_breaches -> selfservice.methods.password.config.max_breaches
password.ignore_network_errors -> selfservice.methods.password.config.ignore_network_errors

After battling with spf13/viper for several years we finally found a viable alternative with knadh/koanf. The complete internal configuration infrastructure has changed, with several highlights:

Configuration sourcing works from all sources (file, env, cli flags) with validation against the configuration schema, greatly improving developer experience when changing or updating configuration.
Configuration reloading has improved significantly and works flawlessly on Kubernetes.
Performance increased dramatically, completely removing the need for a cache layer between the configuration system and ORY Hydra.
It is now possible to load several config files using the --config flag.
Configuration values are now sent to the tracer (e.g. Jaeger) if tracing is enabled.

Please be aware that ORY Kratos might complain about an invalid configuration, because the validation process has improved significantly.

Bug Fixes

Add include stub go files (6d725b1)
Add index to migration status (8c6ec27)
Add node_modules to format tasks (e5f6b36)
Add titles to identity schema (73c15d2)
Adopt to new go-swagger changes (5c45bd9)
Allow absolute file URLs as config values (#1069) (4bb4f67)
Allow hashtag in ui urls (#1040) (7591f07)
Avoid unicode-escaping ampersand in recovery URL query string (#1212) (d172368)
Bcrypt regression in credentials counting (23fc13b)
Broken make quickstart-dev task (#980) (999828a), closes #965
Broken make sdk task (#977) (5b01c7a), closes #950
Call contextualized test helpers (e1f3f78)
cmd: Make HTTP calls resilient (e8ed61f)
Code integer parsing bit size (#1178) (31e9632):

In some cases we had a wrong bitsize of 64, while the var was later cast to int. Replaced with a bitsize of 0, which is the value to cast to int.
Contextualize identity persister (f8640c0)
Convert all identifiers to lower case on login (#815) (d64b575), closes #814
Courier adress (#1198) (ebe4e64), closes #1194
Courier message dequeue race condition (#1024) (5396a82), closes #652 #732:

Fixes the courier message dequeuing race condition by modifying *sql.Persister.NextMessages(ctx context.Context, limit uint8) to retrieve only messages with status MessageStatusQueued and update the status of the retrieved messages to MessageStatusProcessing within a transaction. On message send failure, the message's status is reset to MessageStatusQueued, so that the message can be dequeued in a subsequent NextMessages call. On message send success, the status is updated to MessageStatusSent (no change there).
Define credentials types as sql template and resolve crdb issue (a2d6eeb)
Dereference pointer types from new flow structures (#1019) (efedc92)
Do not include smtp in tracing (#1268) (bbfcbf9)
Do not publish version at public endpoint (3726ed4)
Do not reset registration method (554bb0b)
Do not return system errors for missing identifiers (1fcc855), closes #1286
Export mailhog dockertest runner (1384148)
Fix random delay norm distribution math (#1131) (bd9d28f)
Fork audit logger from root logger (68a09e7)
Gitlab oidc flow (#1159) (0bb3eb6), closes #1157
Give specific message instead of only 404 when method is disabled (#1025) (2f62041):

Enabled strategies are not only used for handlers but also in other areas (e.g. populating the flow methods). So we should keep the logic to get enabled strategies and add new functions for getting all strategies.
hashing: Make bcrypt default hashing algorithm (04abe77)
Ignore unset domain aliases (ada6997)
Improve cli error output (43e9678)
Improve error stack trace (4351773)
Improve error tracing (#1005) (456fd25)
Improve test contextualization (2f92a70)
Initialize randomdelay with seeded source (9896289)
Insert credentials type constants as part of migrations (#865) (92b79b8), closes #861
Linking a connection may result in system error (#990) (be02a70), closes #694
Marking whoami auhorization parameter as 'in header' (#1244) (62d8b85), closes #1215
Move schema loaders to correct file (029781f)
Move to new transaction-safe migrations (#1063) (2588fb4):

This patch introduces a new SQL transaction model for running SQL migrations. This fix is particularly targeted at CockroachDB which has limited support for mixing DDL and DML statements.

Previously it could happen that migrations failure needed manual intervention. This has now been resolved. The new migration model is compatible with the old one and should work without a problem.
Pass down context to registry (0879446)
Re-enable SDK generation (1d5854d)
Record cypress runs (db35d8f)
Rehydrate settings form on successful submission (3457e1a), closes #1305
Remove absolete 'make pack' from Dockerfile (#1172) (b8eb908)
Remove continuity cookies on errors (85eea67)
Remove include stubs (1764e3a)
Remove obsolete clihelpers (230fd13)
Remove record from bash script (84a9315)
Remove stray non-ctx configs (#1053) (1fe137e)
Remove trailing double-dot from error (59581e3)
Remove unused sql migration (1445d1d)
Remove unused var (30a8cee)
Remove verify hook (98cfec6), closes #1302:

The verify hook is automatically used when verification is enabled and has been removed as a configuration option.
Replace jwt module (#1254) (3803c8c), closes #1250
Resolve build and release issues (fb582aa)
Resolve clidoc issues (599e9f7)
Resolve compile issues (63063c1)
Resolve contextualized table issues (5a4f0d9)
Resolve crdb migration issue (9f6edfd)
Resolve double hook invokation for registration (032322c)
Resolve incorrect field types on oidc sign up completion (f88b6ab)
Resolve lint issues (0348825)
Resolve lint issues (75a995b)
Resolve linting issues and disable nancy (c8396f6)
Resolve mail queue issues (b968bc4)
Resolve merge regressions (9862ac7)
Resolve oidc e2e regressions (f28087a)
Resolve oidc regressions and e2e tests (f5091fa)
Resolve potential fsnotify leaks (3159c0a)
Resolve regressions and test failures (8bae356)
Resolve regressions in cookies and payloads (9e34bf2)
Resolve settings sudo regressions (4b611f3)
Resolve test regressions (e3fb028)
Resolve ui issues with nested form objects (8e744b9)
Resolve update regression (d0d661a)
Return delay instead of sleeping to improve tests (27b977e)
Revert generator changes (c18b97f)
Run correct error handler for registration hooks (0d80447)
Simplify data breaches password error reason (#1136) (33d29bf):

This PR simplifies the error reason given when a password has appeared in data breaches to not include the actual number and rather just show "this password has appeared in data breaches and must not be used".
Support form and json formats in decoder (d420fe6)
Update openapi definitions for signup (eb0b69d)
Update quickstart node image (c19b2f4):

See ory#1301
Update to new goreleaser config (4c2a1b7)
Update to new healthx (6ec987a)
Use equalfold (1c0e52e)
Use new TB interface (d75a378)
Use numerical User ID instead of name to avoid k8s security warnings (#1151) (468a12e):

Our docker image scanner does not allow running processes inside container using non-numeric User spec (to determine if we are trying to run docker image as root).
Use remote dependencies (1e56457)

Code Generation

Pin v0.6.0-alpha.1 release commit (507d13a)

Code Refactoring

Adapt new sdk in testhelpers (6e15f6f)
Add nid everywhere (407fd95)
Contextualize everything (7ebc3a9):

This patch contextualizes all configuration and DBAL models.
Do not use prefixed node names (fc42ece)
Improve Argon2 tooling (#961) (3151187), closes #955:

This adds a load testing CLI that allows to adjust the hasher parameters under simulated load.
Move faker to exportable module (09f8ae5)
Move migratest helpers to ory/x (7eca67e)
Move password config to selfservice (cd0e0eb)
Move to go 1.16 embed (43c4a13):

This patch replaces packr and pkged with the Go 1.16 embed feature.
Remove password node attribute prefix (e27fae4)
Remove profile node attribute prefix (a3ff6f7)
Rename config structs and interfaces (4a2f419)
Rename form to container (5da155a)
Replace flow's forms with new ui node module (647eb1e)
Replace flow's forms with new ui node module (f74a5c2)
Replace login flow methods with ui container (d4ca364)
Replace recovery flow methods with ui container (cac0456)
Replace registration flow methods with ui container (3f6388d)
Replace settings flow methods with ui container (0efd17e)
Replace verification flow methods with ui container (dbf2668)
Replace viper with koanf config management (5eb1bc0)
Update RegisterFakes calls (6268310)
Use underscore in webhook auth types (26829d2)

Documentation

Add docker to docs main (8ce8b78)
Add docker to sidebar (ed38c88)
Add dotnet sdk (#1183) (32d874a)
Add faq sidebar (#1105) (10697aa)
Add log docs to schema config (4967f11)
Add more HA docs (cbb2e27)
Add Rust and Dart SDKs (6d96952):

We now support for Rust and Dart SDKs!
Add SameSite help (2df6729)
Add shell-session language (d16db87)
Add ui node docs (e48a07d)
Adding double colons (#1187) (fc712f4)
Bcrypt is default and add 72 char warning (29ae53a)
Better import identities examples (#997) (2e2880a)
Change forum to discussions readme (#1220) (ae39956)
Describe more about Kratos login/browser flow on quickstart doc (#1047) (fe725ad)
Docker file links (#1182) (4d9b6a3)
Document hash timing attack mitigation (ec86993)
Explain how to use after_verification_return_to (7e1546b)
FAQ improvements (#1135) (44d0bc9)
FAQ item & minor changes (#1174) (11cf630)
Fix broken link (#1037) (6b9aae8)
Fix failing build (0de328f)
Fix formatting (#966) (687251a)
Fix identity state bullets (#1095) (f476334)
Fix known/unknown email account recovery (#1211) (e208ca5)
Fix link (7f6d7f5)
Fix link (#1128) (e7043e9)
Fix link to blogpost (#949) (4622e32), closes #945
Fix link to self-service flows overview (#995) (2be8778)
Fix note block in third party login guide (#920) (745cea0):

Allows the document to render properly
Fix npm links (#991) (4ce4468)
Fix self-service code flows labels (#1253) (f2ed424)
Fix typo in README (#1122) (e500707)
Link to argon2 blogpost and add cross-references (#1038) (9ab7c3d)
Make explicit the ID of the default schema (#1173) (cc6e9ff)
Minor cosmetics (#1050) (34db06f)
Minor improvements (#1052) (f0672b5)
ORY -> Ory (ea30979)
prometheus: Update codedoc (47146ea)
Reformat settings code samples (cdbbf4d)
Remove unnecessary and wrong docker pull commands (#1203) (2b0342a)
Resolve duplication error (a3d8284)
Update build from source (9b5754f), closes #979
Update email template docs (1778cb9), closes #897
Update identity-data-model links (b5fd9a3)
Update identity.ID field documentation (4624f03):

See ory#956
Update kratos video link (#1073) (e86178f)
Update login code samples (695a30f)
Update login code samples (ce6c755)
Update quickstart samples (c3fcaba)
Update recovery code samples (d9fbb62)
Update registration code samples (317810f)
Update self-service code samples (6415011)
Update settings code samples (bbd6266)
Update verification code samples (4285dec)
Use correct extension for identity-data-model (acab3e8), closes /github.com/ory/kratos/pull/1197#issuecomment-819455322

Features

Add email template specification in doc (#898) (4230d9e)
Add error for when no login strategy was found (6bae66c)
Add facebook provider to oidc providers and documentation (#1035) (905bb03), closes #1034
Add FAQ to docs (#1096) (9c6b68c)
Add gh login to claims (49deb2e)
Add login strategy text message (7468c83)
Add more tests for multi domain args (e99803b)
Add Prometheus monitoring to Public APIs (#1022) (75a4f1a)
Add random delay to login flow (#1088) (cb9894f), closes #832
Add return_url to verification flow (#1149) (bb99912), closes #1123 #1133
Add sql migrations for new login flow (e947edf)
Add sql tracing (3c4cc1c)
Add tracing to config schema (007dde4)
Add transporter with host modification (2c41b81)
Add workaround template for go openapi (5d72d10)
Adds slack sogial login (#974) (7c66053), closes #953
Allow session cookie name configuration (77ce316), closes #268
Allow specifying sender name in smtp.from_address (#1100) (5904fe3)
Bcrypt algorithm support (#1169) (b2612ee):

This patch adds the ability to use BCrypt instead of Argon2id for password hashing. We recommend using BCrypt for web workloads where password hashing should take around 200ms. For workloads where login takes >= 2 seconds, we recommend to continue using Argon2id.

To use bcrypt for password hashing, set your config as follows:
```
hashers:
bcrypt:
   cost: 12
 algorithm: bcrypt
```
Switching the hashing algorithm will not break existing passwords!

Co-authored-by: Patrik zepatrik@users.noreply.github.com
Check migrations in health check (c6ef7ad)
Configure domain alias as query param (9d8563e)
Contextualize configuration (d3d5327)
Contextualize health checks (8145a1c)
Contextualize http client in cli calls (3b3ef8f)
Contextualize persitence testers (6440373)
Courier foreground worker with "kratos courier watch" (#1062) (500b8ba), closes #1033 #1024:

BREACKING CHANGES: This patch moves the courier watcher (responsible for sending mail) to its own foreground worker, which can be executed as a, for example, Kubernetes job.

It is still possible to have the previous behaviour which would run the worker as a background task when running kratos serve by using the --watch-courier flag.

To run the foreground worker, use kratos courier watch -c your/config.yaml.
courier: Allow sending individual messages (cbb2c0b)
Do not enforce bcrypt 12 for dev envs (bbf44d8)
Email input validation (#1287) (cd56b73), closes #1285
Export and add config options (4391fe5)
Expose courier worker (f50969e)
Expose crdb ui (504d518)
Global docs sidebar (#1258) (7108262)
Implement and test domain aliasing (1516a54):

This patch adds a feature called domain aliasing. For more information, head over to http://ory.sh/docs/kratos/next/guides/multi-domain-cookies
Improve oas spec and fix mobile tests (4ead2c8)
Improve sorting of ui fields (797b49d):

See ory#1196
Include schema (348a493)
Make cli commands consumable in Ory Cloud (#926) (fed790b)
Migrate to openapi v3 (595224b)
oidc: Support google hd claim (#1097) (1f20a5c)
Populate email templates at delivery time, add plaintext defaults (#1155) (7749c7a), closes #1065
schema: Add totp errors (a61f881)
Sort and label nodes with easy to use defaults (cbec27c):

Ory Kratos takes a guess based on best practices for
- ordering UI nodes (e.g. email, password, submit button)
- grouping UI nodes (e.g. keep password and oidc nodes together)
- labeling UI nodes (e.g. "Sign in with GitHub")
- using the "title" attribute from the identity schema to label trait fields
This greatly simplifies front-end code on your end and makes it even easier to integrate with Ory Kratos! If you want a custom experience with e.g. translations or other things you can always adjust this in your UI integration!
Support base64 inline schemas (815a248)
Support contextual csrf cookies (957ef38)
Support domain aliasing in session cookie (0681c12)
Support label in oidc config (a99cdcd)
Support retryable CRDB transactions (f0c21d7)
Unix sockets support (#1255) (ad010de)
Web hooks support (recovery) (#1289) (3e181fe), closes #271:

feat: web hooks for self-service flows

This feature adds the ability to define web-hooks using a mixture of configuration and JsonNet. This allows integration with services like Mailchimp, Stripe, CRMs, and all other APIs that support REST requests. Additional to these new changes it is now possible to define hooks for verification and recovery as well!

For more information, head over to the hooks documentation.

Tests

Add case to ensure correct behavior when verifying a different email address (#999) (f95a117), closes #998
Add oasis test case (f80691b)
Bump poll interval (b3dc925)
Bump video quality (b7f8d04)
Bump wait times (b2e43f8)
Clean up hydra env before restart (cf49414)
e2e: Significantly reduce wait and idle times (f525fc5)
Longer wait times (4bec9ef)
Reliable migration tests on crdb (2e3764b)
Remove old noop test (16dca3f)
Resolve compile issues (c1b5ba4)
Resolve flaky tests (cb670a8)
Resolve json parser test regression (a1b9b9a)
Resolve login integration regressions (388b5b2)
Resolve migration regression (2051a71)
Resolve more json parser test regressions (ff791c4)
Resolve more regressions (c5a23af)
Resolve order regression (40a849c)
Resolve regression (e2b0ad3)
Resolve regression (f0c9e5f)
Resolve regressions (4b9da3c)
Resolve stub regressions (82650cf)
Resolve test migrations (de0b65d)
Resolve test regression issues (ccf9fed)
Speed up tests (a16737c)
Update schema tests for webhooks (d1ddfa8)
Update test description (55fb37f)
Use bcrypt cost 4 to reduce CI times (cabe97d)
Use fast bcrypt for e2e (d90cf13)

Unclassified

fix: resolve clidoc issues (#976) (346bc73), closes #976 #951
🐛 fix ory home directory path (#897) (2fca2be), closes #897
Fix typo in config schema (16337f1)
Format (e4b7e79)
Format (193d266)
Format (1ebfbde)
Format (ba1eeef)
Format (ada5dbb)
Format (17a0bf5)
Initial documentation tests via Text-Runner (#567) (c30eb26)

0.5.5-alpha.1 (2020-12-09)

The ORY Community is proud to present you the next iteration of ORY Kratos. In this release, we focused on improving production stability!

Bug Fixes

CSRF token is required when using the Revoke Session API endpoint (#839) (d3218a0), closes #838
Incorrect home path (#848) (5265af0)
Make password policy configurable (#888) (7a00483), closes #450 #316:

Allows configuring password breach thresholds and optionally enforces checks against the HIBP API.
Remove obsolete types (#887) (b8bac7a), closes #716
Set samesite attribute to lax if in dev mode (#824) (91d6698), closes #821
Use working cache-control header for cdn/proxies/cache (#869) (d8e3d40), closes #601

Code Generation

Pin v0.5.5-alpha.1 release commit (83aedcb)

Documentation

Add contributing to sidebar (#866) (44f33f9):

The same change as in ory/hydra#2209
Add newsletter to config (1735ca2)
Add recovery flow (#868) (d95cfe9), closes #864:

Added a short section for the recovery flow on managing-user-identities.
Fix account recovery click instruction (#870) (383de9e)
Fix broken link (#893) (dec38a2), closes #835
Fix oidc config example structure (#845) (c102a68)
Fix redirect (#802) (b868782)
Fix typo (#847) (9b3da9f)
Fix typo (#881) (3078293)
Fix typo MKFA to MFA (#826) (a5613d0)
Remove workaround note (#886) (05409bc), closes #718
Swagger specs for selfservice settings browser flow (#825) (28d50f4)
Update oidc provider with json conf support (#833) (670eb37)

Features

Add return_to parameter to logout flow (#823) (1c146dd), closes #702
Add selinux compatible quickstart config (#889) (0f87948), closes #831

Tests

Ensure registration runs only once (#872) (5ffc036)

Unclassified

docs: fix link and typo in Configuring Cookies (#883) (c51ed6b), closes #883

0.5.4-alpha.1 (2020-11-11)

This release introduces the new CLI command kratos hashers argon2 calibrate 500ms. This command will choose the best parameterization for Argon2. Check out the Choose Argon2 Parameters for Secure Password Hashing and Login blog article for more insights!

Bug Fixes

Case in settings handler method (#798) (83eb4e0)
Force brew install statement (#796) (ad542ad):

Closes ory/homebrew-kratos#1

Code Generation

Pin v0.5.4-alpha.1 release commit (b02926c)

Code Refactoring

Move pkger and ioutil helpers to ory/x (60a0fc4)

Documentation

Fix another broken link (15bae9f)
Fix broken links (#795) (0ab0e7e), closes #793
Fix broken relative link (#812) (b32b173)
Fix links (#800) (5fcc272)
Fix oidc config examples (#799) (8a4f480)
Fix self-service recovery flow typo (#807) (800110d)
Remove duplicate words & fix spelling (#810) (4e1b966)
Remove leftover category from reference sidebar (#813) (94fde51)
Use correct links (#797) (a4de293)

Features

Add helper for choosing argon2 parameters (#803) (ca5a69b), closes #723 #572 #647:

This patch adds the new command "hashers argon2 calibrate" which allows one to pick the desired hashing time for password hashing and then chooses the optimal parameters for the hardware the command is running on:

$ kratos hashers argon2 calibrate 500ms
Increasing memory to get over 500ms:
    took 2.846592732s in try 0
    took 6.006488824s in try 1
  took 4.42657975s with 4.00GB of memory
[...]
Decreasing iterations to get under 500ms:
    took 484.257775ms in try 0
    took 488.784192ms in try 1
  took 486.534204ms with 3 iterations
Settled on 3 iterations.

{
  "memory": 1048576,
  "iterations": 3,
  "parallelism": 32,
  "salt_length": 16,
  "key_length": 32
}

0.5.3-alpha.1 (2020-10-27)

This release improves the developer and user experience around CSRF counter-measures. It should now be possible to use the self-service API flows without having to explicitly disable cookie features in your SDKs and integrations. Additionally, another issue in the CGO pipeline was resolved which finally allows running ORY Kratos without CGO if the target database is not SQLite.

Further improvements to default config values have been made and a full end-to-end test suite for the exemplary kratos-selfservice-ui-react-native app. The app is now available in the iTunes store as well - just search for "ORY Profile App"!

Bug Fixes

Add "x-session-token" to default allowed headers (3c912e4)
Do not set cookies on api endpoints (2f67c28)
Do not set csrf cookies on potential api endpoints (4d97a95)
Ignore unsupported migration dialects (12bb8d1), closes #778:

Skips sqlite3 migrations when support is lacking.
Improve semver regex (584c0b5)
Properly set nosurf context even when ignored (0dcb774)
Update cypress (ba8b172)
Use correct regex for version replacement (ce870ab), closes #787

Code Generation

Pin v0.5.3-alpha.1 release commit (64dc91a)

Documentation

Fix docosaurus admonitions (#788) (281a7c9)
Pin download script version (e4137a6)
Remove trailing garbage from quickstart (#787) (7e70924)

Features

Improve makefile install process and update deps (d1eb37f)

Tests

Add e2e tests for mobile (d481d51)
Add option to disable csrf protection in apis (a0077f1)
Bump wait time (7a719e1)
Install expo-cli globally (db21cfa)
Install expo-cli in cci config with sudo (d255f46)
Log wait-on output (62b5ba9)
Output web server address (cb41ca7)
Resolve csrf test issues in settings (ef8ba7d)
Resolve test panic (6f6461f)
Revert delay increase and improve install scripts (1eafcaa)

0.5.2-alpha.1 (2020-10-22)

This release addresses bugs and user experience issues.

Bug Fixes

Add debug quickstart yml (#780) (16e6b4d)
Gracefully handle double slashes in URLs (aeb9414), closes #779
Merge gobuffalo CGO fix (fea2e77)
Remove obsolete recovery_token and add link to schema (acf6ac4)
Return correct error in login csrf (dd9cab0), closes #785
Use correct assert package (76be5b0)

Code Generation

Pin v0.5.2-alpha.1 release commit (79fcd8a)

Documentation

Small improvements to discord oidc provider guide (#783) (6a3c453)

Tests

Add tests for csrf behavior (48993e2), closes #785
Mark link as enabled in e2e test (c214b81)
Resolve schema test regression (bb7af1b)

0.5.1-alpha.1 (2020-10-20)

This release resolves an issue where ORY Kratos Docker Images without CGO and SQLite support would fail to boot even when SQLite was not used as a data source.

Bug Fixes

Do not require sqlite without build tag (2ee787b)
Use extra dc config file for quickstart-dev (72c03f9)

Code Generation

Pin v0.5.1-alpha.1 release commit (b85b36b)

Documentation

Fix spelling mistake (14e7f65)
Fix spelling mistake (#772) (bf401a2)
Improve schemas (#773) (e614859)

Features

Auto-update docker and git tags on release (08084a9)
Use fixed versions for docker-compose (e73c4ce)

Tests

Increase waittime (5e911d6)
Reduce flakes by increasing wait time for expiry test (cddf29e)

Unclassified

Format (8be02c8)

0.5.0-alpha.1 (2020-10-15)

The ORY team and community is very proud to present the next ORY Kratos iteration!

ORY Kratos is now capable of handling native (iOS, Android, Windows, macOS, ...) login, registration, settings, recovery, and verification flows. As a goodie on top, we released a reference React Native application which you can find on GitHub.

We co-released our reference React Native application which acts as a reference on implementing these flows:

In total, almost 1200 files were changed in about 480 commits. While you can find a list of all changes in the changelist below, these are the changes we are most proud of:

We renamed login, registration, ... requests to "flows" consistently across the code base, APIs, and data storage. We now:
- Initiate a login, registration, ... flow;
- Fetch a login, registration, ... flow; and
- Complete a login, registration, ... flow using a login flow method such as "Log in with username and password".
All self-service flows are now capable of handling API-based requests that do not originate from Browser such as Chrome. This is set groundwork for handling native flows (see above)!
The self service documentation has been refactored and simplified. We added code samples, screenshots, payloads, and curl commands to make things easier and clearer to understand. Video guides have also been added to help you and the community get things done faster!
Documentation for rotating important secrets such as the cookie and session secrets was added.
The need for reverse proxies was removed by adding the ability to change the ORY Kratos Session Cookie domain and path! The kratos-selfservice-ui-node reference implementation no longer requires HTTP Request piping which greatly simplifies the network layout and codebase!
The ORY Kratos CLI is now capable of managing identities with an interface that works almost like the Docker CLI we all love!
Admins are now able to initiate account recovery for identities.
Email verification and account recovery were refactored. It is now possible to add additional strategies (e.g. recovery codes) in the future, greatly increasing the feature set and security capabilities of future ORY Kratos versions!
Lookup to Have I Been Pwnd is no longer a hard requirement, allowing registration processes to complete when the service is unavailable or the network is slow.
We contributed several issues and features in upstream projects such as justinas/nosurf, gobuffalo/pop, and many more!
The build pipeline has been upgraded to support cross-compilation of CGO with Go 1.15+.
Fetching flows no longer requires CSRF cookies to be set, improving developer experience while not compromising on security!
ORY Kratos now has ORY Kratos Session Cookies (set in the HTTP Cookie header) and ORY Kratos Session Tokens (set as a HTTP Bearer Authorization token or the X-Session-Token HTTP Header).

Additionally tons of bugs were fixed, tests added, documentation improved, and much more. Please note that several things have changed in a breaking fashion. You can find details for the individual breaking changes in the changelog below.

We would like to thank all community members who contributed towards this release (in no particular order):

https://github.com/kevgo
https://github.com/NickUfer
https://github.com/drwatsno
https://github.com/alsuren
https://github.com/wezzle
https://github.com/sherbang
https://github.com/perryao
https://github.com/jikunchong
https://github.com/err0r500
https://github.com/debrutal
https://github.com/c0depwn
https://github.com/aschepis
https://github.com/jakhog

Have fun exploring the new release, we hope you like it! If you haven't already, join the ORY Community Slack where we hold weekly community hangouts via video chat and answer your questions, exchange ideas, and present new developments!

Breaking Changes

The "common" keyword has been removed from the Swagger 2.0 spec which deprecates the common module / package / class (depending on the generated SDK). Please use public or admin instead!

Additionally, the SDK for TypeScript now uses the fetch API which allows the SDK to be used in both client-side as well as server-side contexts. Please note that several methods and parameters in the generated TypeScript SDK have changed. Please check the TypeScript results to see what needs to be changed!

This patch changes the OpenID Connect and OAuth2 ("Sign in with Google, Facebook, ...") Callback URL from http(s)://<kratos-public>/self-service/browser/flows/strategies/oidc/<provider> to http(s)://<kratos-public>/self-service/methods/oidc/<provider>. To apply this patch, you need to update these URLs at the OAuth2 Client configuration pages of the individual OpenID Conenct providers (e.g. GitHub, Google).

Configuration key selfservice.strategies was renamed to selfservice.methods.

This patch significantly changes how email verification works. The Verification Flow no longer uses its own system but now re-uses the API and Browser flows and flow methods established in other components such as login, recovery, registration.

Due to the many changes these patch notes does not cover how to upgrade this particular flow. We instead want to kindly ask you to check out the updated documentation for this flow at: https://www.ory.sh/kratos/docs/self-service/flows/verify-email-account-activation

This patch changes the SQL schema and thus requires running the SQL Migration command (e.g. ... migrate sql). Never apply SQL migrations without backing up your database prior.

Configuration items selfservice.flows.<name>.request_lifespan have been renamed to selfservice.flows.<name>.lifespan to match the new flow semantics.

Wording has changed from "Self-Service Recovery Request" to "Self-Service Recovery Flow" to follow community feedback and practice already applied in the documentation. Additionally, fetching a recovery flow over the public API no longer requires Anti-CSRF cookies to be sent.

This patch renames several important recovery flow endpoints:

/self-service/browser/flows/recovery is now /self-service/recovery/browser without functional changes.
/self-service/browser/flows/requests/recovery?request=abcd is now /self-service/recovery/flows?id=abcd and no longer needs anti-CSRF cookies to be available.

Additionally, the URL for completing the password and oidc recovery method has been moved. Given that this endpoint is typically not manually called, you can probably ignore this change:

/self-service/browser/flows/recovery/link?request=abcd is now /self-service/recovery/methods/link?flow=abcd without functional changes.

The Recovery UI Endpoint no longer receives a ?request=abcde query parameter but instead a ?flow=abcde query parameter. Functionality did not change however.

As part of this change SDK methods have been renamed:

  const kratos = new CommonApi(config.kratos.public)
  // ...
- kratos.completeSelfServiceBrowserRecoveryLinkStrategyFlow(req.query.request)
+ kratos.completeSelfServiceRecoveryFlowWithLinkMethod(req.query.flow)

This patch requires you to run SQL migrations.

Wording has changed from "Self-Service Settings Request" to "Self-Service Settings Flow" to follow community feedback and practice already applied in the documentation.

This patch renames several important settings flow endpoints:

/self-service/browser/flows/settings is now /self-service/settings/browser without functional changes.
/self-service/browser/flows/requests/settings?request=abcd is now /self-service/settings/flows?id=abcd and no longer needs anti-CSRF cookies to be available.

Additionally, the URL for completing the password, profile, and oidc settings method has been moved. Given that this endpoint is typically not manually called, you can probably ignore this change:

/self-service/browser/flows/login/strategies/password?request=abcd is now /self-service/login/methods/password?flow=abcd without functional changes.
/self-service/browser/flows/strategies/oidc?request=abcd is now /self-service/methods/oidc?flow=abcd without functional changes.
/self-service/browser/flows/settings/strategies/profile?request=abcd is now /self-service/settings/methods/profile?flow=abcd without functional changes.

The Settings UI Endpoint no longer receives a ?request=abcde query parameter but instead a ?flow=abcde query parameter. Functionality did not change however.

As part of this change SDK methods have been renamed:

  const kratos = new CommonApi(config.kratos.public)
  // ...
- kratos.getSelfServiceBrowserSettingsRequest(req.query.request)
+ kratos.getSelfServiceSettingsFlow(req.query.flow)

  // You will most likely not be using this:
  const kratos = new PublicApi(config.kratos.public)
- kratos.completeSelfServiceBrowserSettingsPasswordStrategyFlow //...
- kratos.completeSelfServiceSettingsFlowWithPasswordMethod //..
- kratos.completeSelfServiceBrowserSettingsProfileStrategyFlow //...
- kratos.completeSelfServiceSettingsFlowWithProfileMethod //..

This patch requires you to run SQL migrations.

This patch makes the reverse proxy functionality required in prior versions of the self-service UI example obsolete. All examples work now with a simple set up and documentation has been added to assist in subdomain scenarios.

The session field sid has been renamed to id to stay consistent with other APIs which also use id terminology to clarify identifiers. The payload of, for example, /session/whoami has changed as follows:

  {
-   "sid": "abcde",
+   "id": "abcde",
    "expires_at": "..."
    "identity": {
      // ..
    }
  }

Wording has changed from "Self-Service Registration Request" to "Self-Service Registration Flow" to follow community feedback and practice already applied in the documentation. Additionally, fetching a login flow over the public API no longer requires Anti-CSRF cookies to be sent.

This patch renames several important registration flow endpoints:

/self-service/browser/flows/registration is now /self-service/registration/browser without behavioral change.
/self-service/browser/flows/requests/registration?request=abcd is now /self-service/registration/flows?id=abcd and no longer needs anti-CSRF cookies to be available.

Additionally, the URL for completing the password registration method has been moved. Given that this endpoint is typically not manually called, you can probably ignore this change:

/self-service/browser/flows/registration/strategies/password?request=abcd is now /self-service/registration/methods/password?flow=abcd without functional changes.
/self-service/browser/flows/strategies/oidc?request=abcd is now /self-service/methods/oidc?flow=abcd without functional changes.

The Registration UI Endpoint no longer receives a ?request=abcde query parameter but instead a ?flow=abcde query parameter. Functionality did not change however.

As part of this change SDK methods have been renamed:

  const kratos = new CommonApi(config.kratos.public)
  // ...
- kratos.getSelfServiceBrowserRegistrationRequest(req.query.request)
+ kratos.getSelfServiceRegistrationFlow(req.query.flow)

This patch requires you to run SQL migrations.

Existing login sessions will no longer be valid because the session cookie data model changed. If you apply this patch, your users will need to sign in again.

Wording has changed from "Self-Service Login Request" to "Self-Service Login Flow" to follow community feedback and practice already applied in the documentation. Additionally, fetching a login flow over the public API no longer requires Anti-CSRF cookies to be sent.

This patch renames several important login flow endpoints:

/self-service/browser/flows/login is now /self-service/login/browser without functional changes.
/self-service/browser/flows/requests/login?request=abcd is now /self-service/login/flows?id=abcd and no longer needs anti-CSRF cookies to be available.

Additionally, the URL for completing the password and oidc login method has been moved. Given that this endpoint is typically not manually called, you can probably ignore this change:

/self-service/browser/flows/login/strategies/password?request=abcd is now /self-service/login/methods/password?flow=abcd without functional changes.
/self-service/browser/flows/strategies/oidc?request=abcd is now /self-service/methods/oidc?flow=abcd without functional changes.

The Login UI Endpoint no longer receives a ?request=abcde query parameter but instead a ?flow=abcde query parameter. Functionality did not change however.

As part of this change SDK methods have been renamed:

  const kratos = new CommonApi(config.kratos.public)
  // ...
- kratos.getSelfServiceBrowserLoginRequest(req.query.request)
+ kratos.getSelfServiceLoginFlow(req.query.flow)

This patch requires you to run SQL migrations.

Configuraiton value session.cookie_same_site has moved to session.cookie.same_site. There was no functional change.

Bug Fixes

Add missing 'recovery' path in oathkeeper access-rules.yml (#763) (f180dba)
Add missing error handling (43c1446)
Add ory-prettier-styles to main repo (#744) (aeaddbc)
Add remote help description (f66bbe1)
Add serve help description (2eb072b)
Allow using json with form layout in password registration (bd2225c)
Annotate whoami endpoint with cookie and token (a8a781c)
Bump datadog version to fix build failure (4dfd322)
Change KRATOS_ADMIN_ENDPOINT to KRATOS_ADMIN_URL (763fdc5)
Clarify fetch use (8eb2e6f)
Complete verification by redirecting to UI with success (f0ecf51)
Correct cookie domain on logout (#646) (6d77e04), closes #645
Correct help message for import (a5f46d2)
Correct password and profile swagger annotations (668c184)
Correct password registration method api spec (08dd582)
Correct PHONY spelling (#739) (e3d3617)
Cover more test cases for persister (37d2e08)
Create decoder only once (34dc43b)
Deprecate packr2 dependency in makefile (be9a84d), closes #711 #750
Do not propagate parent validation error (bf6093d)
Don't resend verification emails once verified (#583) (a4d9969), closes #578
Enforce endpoint to be set (171ac18)
Escape jsx characters in api documentation (0946094)
Exit with code 1 on unimplemented CLI commands (66943d7)
Explicitly ignore fprint return values (f50e582)
Explicitly ignore fprintf results (a83dc50)
Fallback to default return url if logout after url is not defined (#594) (7edd367)
Favor packr2 over pkger (ac18a45):

See markbates/pkger#117
Find and replace "request" references (41fb673)
Force exe buildmode for windows CGO (e017bb5)
Html form parse regression issue (6b07cbb)
Ignore x/net false positives (7044b95)
Improve debugging output for login hook and restructure files (dabac40)
Improve debugging output for registration hook and restructure files (ec11775)
Improve expired error responses (124a92e)
Improve hook tests (55ba485)
Improve makefile dependency building (8e1d69a)
Improve pagination when listing identities (c60bf44)
Improve post login hook log and audit messages (ddd5d5a)
Improve post registration hook log and audit messages (2495629)
Improve registration hook tests (8163152)
Improve session max-age behavior (65189fe), closes #42
Keep HTML form type on registration error (#698) (6c9e756), closes #670
Lowercase emails on login (244b4dd)
Mark flow methods' fields as required (#708) (834c607)
Merge public and admin login flow fetch handlers (48c4906)
Missing write in registration error handler (3b2af53)
Properly annotate swagger password parameters (2ef57c4)
Properly fetch identity for session (7be4086)
Recursive loop on network errors in password validator (#589) (b4d5a42), closes #316:

The old code no error when ignoreNetworkErrors was set to true, but did not set a hash result which caused an infinite loop.
Remove incorrect security specs (4c3d46d)
Remove obsolete tests (f102f95):

The test is no longer valid as CSRF checks now happen after checking for login sessions in settings flows.
Remove redirector from code base (6689ecf)
Remove stray debug statements (a8e1ec4)
Rename import to put (8003e0f)
Rename quickstart config files and path (#671) (be8b9e5)
Rename quickstart schema file name (e943c90)
Rename recovery models and generate SDKs (d764435)
Resolve and test for missing data when updating flows (045ecab)
Resolve broken csrf tests (6befe2e)
Resolve broken docs links (56f4a39)
Resolve broken migrations and bump fizz (1ed9c70)
Resolve broken OIDC tests and disallow API flows (9986d8f)
Resolve cookie issues (6e2b6d2)
Resolve e2e headless test failures (82d506e)
Resolve e2e test failures (2627db2)
Resolve failing test cases (f8647b4)
Resolve flaky passwort setting tests (#582) (c42d936), closes #581 #577
Resolve handler testing issue (4f6bafd)
Resolve identity admin api issues (#586) (feef8a7), closes #435 #500:

This patch resolves several issues that occurred when creating or updating identities using the Admin API. Now, all hooks are running properly and updating privileged properties no longer causes errors.
Resolve interface type issues (064b305)
Resolve logout csrf issues (#761) (74c0aac)
Resolve migratest failures (e2f34d3)
Resolve migratest ordering failing tests (dffecc0)
Resolve migration issues (b545e15)
Resolve panic on serve (ae34155)
Resolve panic when DSN="memory" (#574) (05e55f3):

Executing the migration logic in registry.go cause a panic as the registry is not initalized at that point. Therefore we decided to move the handling to driver_default.go, after the registry has been initialized.
Resolve pkger issues (294066c)
Resolve remaining testing issues (af40d93)
Resolve SQL persistence tester issues (4952df4)
Resolve swagger issues and regenerate SDK (be4c7e4)
Resolve template loading issue (145fb20)
Resolve test issues introduced by new csrf protection (625ef5e)
Resolve verification sql errors (784da53)
Resolves a bug that prevents sessions from expiring (#612) (86b281a), closes #611
Revert disabling swagger flatten during sdk generation (98c7915)
Set correct path for kratos in oathkeeper set up (414259f)
Set quickstart logging to trace (d3e9192)
Support browser flows only in redirector (cab5280)
Swagger models (1b5f9ab):

The swagger:parameters <id> definitions for updateIdentity and createIdentity where defined two times with the same ID. They had some old definition swagger used. The internal/httpclient should now work again as expected.
Tell tls what the smtps server name is (#634) (b724038)
Type (e264c69)
Update cli documentation examples (216ea7f)
Update contrib samples (79d24b4)
Update crdb quickstart version (249a6ba)
Update import description (aef1e1a)
Update quickstart kratos config (e3246e5)
Update recovery token field and column names (42abfa1)
Update status help description (b147831)
Update swagger names and fix broken tests (85b7fb1)
Update version help description (8bf4a79)
Use and test for csrf tokens and prevent api misuse (a4e3bc5)
Use correct HTTP method for password login (4f4fcee)
Use correct log message (53c384a)
Use correct redirection for registration (8d47113)
Use correct security annotation (c9bebe0)
Use correct swagger tags and regenerate (df99d8c)
Use helpers to create flow (aba8610)
Use nosurf fork to address VerifyToken bug (cd84e51)
Use params per_page and page for pagination (5dfb6e3)
Use proper pwd in makefile (52e22c3)
Use public instead of common sdk (dcb4a36)
Use relative threshold to judge longest common substring in password policy (#585) (3e9f8cc), closes #581
Whoami returns 401 not 403 (3b3b78c), closes #729

Code Generation

Pin v0.5.0-alpha.1 release commit (557d37d)

Code Refactoring

Add flow methods to verification (00ee828):

Completely refactors the verification flow to support other methods. The original email verification flow now moved to the "link" method also used for recovery.

Additionally, several upstream bugs in gobuffalo/pop and gobuffalo/fizz have been addressed, patched, and merged which improves support for SQLite and CockroachDB migrations:
- gobuffalo/fizz#97
- gobuffalo/fizz#96
Add method and rename request to flow (006bf56)
Change oidc callback URL (36d9380)
Complete login flow refactoring (ad2b3db)
Dry up login.NewFlow (f261c44)
Improve CSRF infrastructure (7e367e7)
Improve login test reuse (b4184e5)
Improve NewFlowExpiredError (1caefac)
Improve registration tests with testhelpers (9bf4530)
Improve selfservice method tests (df4d06d)
Improve settings helper functions (fda17ca)
Move samesite config to cookie parent-key (753eb86)
Moved clihelpers to ory/x (#756) (6ccffa8):

Contributes to ory/hydra#2124.
Profile settings method is now API-able (c5f361f)
Remove common keyword from API spec (6619562)
Remove need for reverse proxy in selfservice-ui (beb4c32), closes #661
Rename session.sid to session.id (809fe73)
Rename login request to login flow (9369d1b), closes #635:

As part of this change, fetching a login flow over the public API no longer requires Anti-CSRF cookies to be sent.
Rename LoginRequestErrorHandler to LoginFlowErrorHandler (66ae029)
Rename package recoverytoken to link (f87fb54)
Rename recovery request to flow internally (16c5618)
Rename recovery request to recovery flow (b0f433d), closes #635:

As part of this change, fetching a login flow over the public API no longer requires Anti-CSRF cookies to be sent.
Rename registration request to flow (8437ebc)
Rename registration request to registration flow (0470956), closes #635:

As part of this change, fetching a registration flow over the public API no longer requires Anti-CSRF cookies to be sent.
Rename request_lifespan to lifespan (#677) (3c8d5e0), closes #666
Rename strategies to methods (8985189):

This patch renames strategies such as "Username/Email & Password" to methods.
Rename verify to verificaiton (#597) (0ecd69a)
Replace all occurrences of login request to flow (1b3c491)
Replace all registration request occurrences with registration flow (308ef47)
Replace packr2 with pkger fork (4e2acae)
Restructure login package (c99e2a2)
Use session token as cookie identifier (60fd9c2)

Documentation

Add administrative user management guide (b97e0c6)
Add code samples to session checking (eba8eda)
Add configuring introduction (#630) (b8cfb35)
Add descriptions to cobra commands (607b76d)
Add documentation for configuring cookies (e3dbc8a), closes #516
Add domain, subdomain, multi-domain cookie guides (3eb1e59), closes #661
Add github video tutorial (#622) (0c4222c)
Add guide for cors (a8ae759)
Add guide for cors (91fd278)
Add guide for dealing with login sessions (4e2718c)
Add identity state (fb4aedb)
Add login session to navbar (b212d64)
Add milestones to sidebar (aae13ec)
Add missing GitLab provider to the list of supported OIDC providers (#766) (a43ed33)
Add missing TOC entries (#748) (bd7edfb)
Add pagination docs (7fe0901)
Add secret key rotation guide (3d6e21a)
Add sequence diagrams for browser/api flows (590d767)
Add session hook to ssi guide (#623) (1bbed39)
Add terminology section (29b81a7)
Add theme helpers and decouple mermaid (7c3eb32)
Add video to OIDC guide (#619) (f286980)
Added sidebar cli label (5d24a29):

clidoc.Generate expects to find an entry under sidebar.json/Reference that contains the substring "CLI" in it's label. Because that was missing, a new entry was appended on every regeneration of the file.
Added sidebar item (#639) (8574761):

Added Kratos Video Tutorial Transcripts document to sidebar.
Added transcript (#627) (cec7f1f):

Added Login with Github Transcript
Adds twitch oidc provider guide (#760) (339e622)
Bring oidc docs up to date (7d0e470)
Changed transcript location (#642) (c52764d):

Changed the location so it is in the right place.
Clarify 302 redirect on expired login flows (ca31b53)
Clarify api flow use (a38b4a1)
Clarify feature-set (2266ae7)
Clarify kratos config snippet (e7732f3)
Clean up docs and correct samples (8627ec5)
Complete registration documentation (b3af02b)
Consistent formatting of badges (#745) (b391a03)
Correct settings and verification redir (30e25e7)
Docker image documentation (#573) (bfe032e)
Document APi flows in self-service overview (71ed0bd)
Document how to check for login sessions (9ad73b8)
Explain high-level API and browser flows (fe3ee0a)
Fix logout url (#593) (f0971d4)
Fix sidebar missing comment (d90123a)
Fix typo (c2f94da)
Fix typo on index page (#656) (907add5)
Fix url of admin-api /recovery/link (#650) (e68c7cb)
Fixed link (c2aebbd)
Fixed link (#629) (ad1276f)
Fixed typos/readability (#620) (7fd3ce0):

Fixed a few typos, and moved some sentences around to improve readability.
Fixed typos/readability (#621) (c4fc75f)
Import mermaid (#696) (6f75004)
Improve charts and examples in self-service overview (312c91d)
Improve documentation and add tests (3dde956)
Improve long messages and render cli documentation (e5fc02f)
Make assumptions neutral in concepts overview (e89d980)
Move development section (2e6f643)
Move hooks (c02b588)
Move to json sidebar (504af3b)
Password login and registration methods for API clients (5a44356)
Prettify all files (#743) (d9d1bfd)
Quickstart next steps (#676) (ee9dd0d):

Added a section outlining some easy config changes, that users can apply to the quickstart to test out different scenarios and configurations.
Refactor login and registration documentation (c660a04)
Refactor settings and recovery documentation (11ca9f7)
Refactor verification docs (70f2789)
Regenerate clidocs with up-to-date binary (e53289c)
Remove make tools task (ec6e664), closes #711 #750:

This task does not exist any more and the dependency building is much smarter now.
Remove contraction (#747) (cd4f21d)
Remove duplicate word (b84e659)
Remove duplicate word (#700) (a12100e)
Remove react native guide for now (daa5f2e)
Rename self service and add admin section (639c424)
Replace ampersand (#749) (8337b80)
Resolve regression issues (0470fd7)
Resolve typo in message IDs (562cfc4)
Resolve typo in message IDs (#607) (f7688f0)
Update cli docs (085efca)
Update link to mfa issue (d03a706)
Update links (a06fd88)
Update MFA link to issue (#690) (7a744ad):

MFA issue was pushed to a later milestone. Update the documentation to point to the issue instead of the milestone.
Update repository templates (f422485)
Update repository templates (#678) (bdb6875)
Update sidebar (ea15c20)
Update ts examples (65cb46e)
Use correct id for multi-domain-cookies (b49288a)
Use correct path in 0.4 docs (9fcaac4), closes #588
Use NYT Capitalization for all Swagger headlines (#675) (6c96429), closes #664

Features

Add ability to configure session cookie domain/path (faeb332), closes #516
Add and improve settings testhelpers (10a43fc)
Add bearer helper (ec6ca20)
Add config version schema (#608) (d218662), closes #590
Add discord oidc provider (#767) (487296d)
Add enum to form field type (96028d8)
Add flow type to login (ce9133b)
Add HTTP request flow validator (1a6e847)
Add new prometheus metrics endpoint #672 (#673) (0f5c436):

Adds endpoint /metrics for prometheus metrics collection to the Admin API Endpoint.
Add nocache helpers (54dcc4d)
Add pagination tests (e3aa81b)
Add session token security definition (d36c26f):

Adds the new Session Token as a Swagger security definition to allow setting the session token as a Bearer token when calling /sessions/whoami.
Add stub errors to errorx (5d452bb), closes #610
Add test helper for fetching settings requests (3646383)
Add tests and helpers to test recovery/verifiable addresses (#579) (29979e6), closes #576
Add tests to cover auth (c9d3a15)
Add texts for settings (795548c)
Add the already declared (and settable) tracer as a middleware (#614) (e24fffe)
Add token to session (08c8c78)
Add type to all flows in SQL (5515776)
Allow import/validation of arrays (d11ac32)
Bump cli and migration render tasks (6dcb42a)
Finalize tests for registration flow refactor (8e52c3a)
Finish off client cli (36d60c7)
Implement administrative account recovery (f5f9c43)
Implement API flow for recovery link method (d65bf66)
Implement API-based tests for password method settings flows (60664aa)
Implement max-age for session cookie (2e642ff), closes #326
Implement tests and anti-csrf for API settings flows (8b8b6e5)
Implement tests for new migrations (e08ece9)
Improve test readability for password method (a896d9b)
Log successful hook execution (f6026cf)
Log successful hook execution (1e7d044)
Make login error handle JSON aware (88f581f)
Make password settings method API-able (0cf6027)
Make public cors configurable (863a0d4), closes #712
Oidc provider claims config option (#753) (bf94a40), closes #735
Reply with cache-control: 0 for browser-facing APIs (1a45b53), closes #360
Schemas are now static assets (1776d58)
Support and document api flow in session issuer hook (91f3cc7)
Support application/json in registration (3476b97), closes #44
Support custom session token header (56bec76):

The /sessions/whoami endpoint now accepts the ORY Kratos Session Token in the X-Session-Token HTTP header.
Support GitLab OIDC Provider (#519) (8580d96), closes #518
Support json payloads for login and password (354e8b2)
Support JSON payloads in password login flow (dd32c23)
Support session token bearer auth and lifecycle (c12600a):

This patch adds support for issuing, validating, and revoking session tokens. Session tokens carry a reference to a session, and are equal to session cookies but can be used on environments which do not support cookies (e.g. React Native) by sending them in the Bearer Authorization.
Update migration tests (fb28173)
Use uri-reference for ui_url etc. to allow relative urls (#617) (2dba450)
Write request -> flow rename migrations (d7189a9)

Tests

Add handler update tests (aea1fb8), closes #325
Add init browser flow tests (f477ece)
Add test for no-cache on public router (b8aa63b)
Add test for registration request (79ed63c)
Add tests for registration flows (4772f71)
Complete test suite for API-based auth (fb9d62f)
Implement API login password tests (8bfd5f2)
Implement API registration password tests (db178b7)
Replace e2e-memory with unit test (52bd839), closes #580
Resolve broken decoder tests (07add1b)
Use correct hook in test (421320c)

Unclassified

u (e207a6a)
As part of this change, fetching a settings flow over the public API no longer requires Anti-CSRF cookies to be sent. (31d560e), closes #635
Create labels.json (68b1f6f)
Add codedoc to identifier hint block (6fe840f)
Format (e61a51d)
Format (1e5b738)
Format code (c3b5ff5)

0.4.6-alpha.1 (2020-07-13)

Resolves build and install issues and includes a few bugfixes.

Bug Fixes

Use proper binary name in dockerfile (d36bbb0)

Code Generation

Pin v0.4.6-alpha.1 release commit (ad90e77):

Bumps from v0.4.4-alpha.1

0.4.5-alpha.1 (2020-07-13)

Resolves build and install issues and includes a few bugfixes.

Bug Fixes

Ensure default_browser_return_url for flows is configured in after (#570) (cf9753c), closes #569
Require selfservice.default_browser_return_url to be set in config (#571) (af2af7d)

Code Generation

Pin v0.4.5-alpha.1 release commit (3ea7fd3):

Bumps from v0.4.4-alpha.1

0.4.4-alpha.1 (2020-07-10)

The purpose of this release is to resolve issues with install scripts, homebrew, and scoop.

Bug Fixes

Detection of SQLite memory mode (#564) (605cd57)
Improve goreleaser config (0f8a0d8)

Code Generation

Pin v0.4.4-alpha.1 release commit (154d543)

Documentation

Add description for subkeys of serve (#562) (deae005)
Add section about password expiry (19c2414)
Specify the use of secrets (#565) (7680450)
Update upgrade guide (a40b1ec)

0.4.3-alpha.1 (2020-07-08)

We are very happy to announce the 0.4 release of ORY Kratos with 163 commits and 817 changed files with 52,681 additions and 9,876 deletions.

There have been many improvements and bugfixes merged. The biggest changes are:

Account recovery ("reset password") has been implemented.
Documentation has been improved with easier to understand examples - currently only for account recovery so let us know what you think!
The configuration has been simplified a lot. It is now much easier to enable account recovery and email verification. This is a breaking change - please read the breaking changes section with care!
The Identity Traits JSON Schema has been renamed to the Identity JSON Schema. This is a breaking change - please read the breaking changes section with care!
prompt=login has been renamed to refresh=true. This is a breaking change - please read the breaking changes section with care!
We have reworked how (error) messages are returned. They now include an ID and all the parameters required for translating and customizing UI messages. This is a breaking change - please read the breaking changes section with care!
Instead of keeping track of update_successful with booleans, flows (e.g. the settings flow) that have more than one state now include a state machine. This is a breaking change - please read the breaking changes section with care!
Tons of tests have been added.
We have reworked and fully tested the migration pipeline to prevent breaking schema changes in future versions.
ORY Kratos now supports login with Azure AD and the Microsoft Identity Platform.

Before upgrading, please make a backup of your database and read the section "Breaking Changes" with care!

Bug Fixes

Resolve goreleaser build issues (223571b)
Update install.sh script (883d99b)

Code Generation

Pin v0.4.3-alpha.1 release commit (a3a34b1):

Bumps from v0.4.0-alpha.1

0.4.2-alpha.1 (2020-07-08)

We are very happy to announce the 0.4 release of ORY Kratos with 153 commits and 760 changed files with 36,223 additions and 9,754 deletions.

There have been many improvements and bugfixes merged. The biggest changes are:

Account recovery ("reset password") has been implemented.
Documentation has been improved with easier to understand examples - currently only for account recovery so let us know what you think!
The configuration has been simplified a lot. It is now much easier to enable account recovery and email verification. This is a breaking change - please read the breaking changes section with care!
The Identity Traits JSON Schema has been renamed to the Identity JSON Schema. This is a breaking change - please read the breaking changes section with care!
prompt=login has been renamed to refresh=true. This is a breaking change - please read the breaking changes section with care!
We have reworked how (error) messages are returned. They now include an ID and all the parameters required for translating and customizing UI messages. This is a breaking change - please read the breaking changes section with care!
Instead of keeping track of update_successful with booleans, flows (e.g. the settings flow) that have more than one state now include a state machine. This is a breaking change - please read the breaking changes section with care!
Tons of tests have been added.
We have reworked and fully tested the migration pipeline to prevent breaking schema changes in future versions.
ORY Kratos now supports login with Azure AD and the Microsoft Identity Platform.

Before upgrading, please make a backup of your database and read the section "Breaking Changes" with care!

Bug Fixes

Ignore pkged generated files (1d385e4)

Code Generation

Pin v0.4.2-alpha.1 release commit (20024cb):

Bumps from v0.4.0-alpha.1

0.4.0-alpha.1 (2020-07-08)

We are very happy to announce the 0.4 release of ORY Kratos with 153 commits and 760 changed files with 36,223 additions and 9,754 deletions.

There have been many improvements and bugfixes merged. The biggest changes are:

Account recovery ("reset password") has been implemented.
Documentation has been improved with easier to understand examples - currently only for account recovery so let us know what you think!
The configuration has been simplified a lot. It is now much easier to enable account recovery and email verification. This is a breaking change - please read the breaking changes section with care!
The Identity Traits JSON Schema has been renamed to the Identity JSON Schema. This is a breaking change - please read the breaking changes section with care!
prompt=login has been renamed to refresh=true. This is a breaking change - please read the breaking changes section with care!
We have reworked how (error) messages are returned. They now include an ID and all the parameters required for translating and customizing UI messages. This is a breaking change - please read the breaking changes section with care!
Instead of keeping track of update_successful with booleans, flows (e.g. the settings flow) that have more than one state now include a state machine. This is a breaking change - please read the breaking changes section with care!
Tons of tests have been added.
We have reworked and fully tested the migration pipeline to prevent breaking schema changes in future versions.
ORY Kratos now supports login with Azure AD and the Microsoft Identity Platform.

Before upgrading, please make a backup of your database and read the section "Breaking Changes" with care! This release requires running SQL migrations when upgrading!

Breaking Changes

This patch renames the Identity Traits JSON Schema to Identity JSON Schema.

The identity payload has changed from

 {
-  "traits_schema_url": "...",
-  "traits_schema_id": "...",
+  "schema_url": "...",
+  "schema_id": "...",
 }

Additionally, it is now expected that your Identity JSON Schema includes a "traits" key at the root level.

Before (example)

{
  "$id": "https://schemas.ory.sh/presets/kratos/quickstart/email-password/identity.schema.json",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "Person",
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "format": "email",
      "title": "E-Mail",
      "minLength": 3,
      "ory.sh/kratos": {
        "credentials": {
          "password": {
            "identifier": true
          }
        },
        "verification": {
          "via": "email"
        },
        "recovery": {
          "via": "email"
        }
      }
    }
  },
  "required": [
    "email"
  ],
  "additionalProperties": false
}

After (example)

{
  "$id": "https://schemas.ory.sh/presets/kratos/quickstart/email-password/identity.schema.json",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "Person",
  "type": "object",
  "properties": {
    "traits": {
      "type": "object",
      "properties": {
        "email": {
          "type": "string",
          "format": "email",
          "title": "E-Mail",
          "minLength": 3,
          "ory.sh/kratos": {
            "credentials": {
              "password": {
                "identifier": true
              }
            },
            "verification": {
              "via": "email"
            },
            "recovery": {
              "via": "email"
            }
          }
        }
      },
      "required": [
        "email"
      ],
      "additionalProperties": false
    }
  }
}

You also need to remove the traits key from your ORY Kratos config like this:

 identity:
-   traits:
-     default_schema_url: http://test.kratos.ory.sh/default-identity.schema.json
-     schemas:
-       - id: other
-         url: http://test.kratos.ory.sh/other-identity.schema.json
+   default_schema_url: http://test.kratos.ory.sh/default-identity.schema.json
+   schemas:
+     - id: other
+       url: http://test.kratos.ory.sh/other-identity.schema.json

Do not forget to also update environment variables for the Identity JSON Schema as well if set.

To address these refactorings, the configuration had to be changed and with breaking changes as keys have moved or have been removed.

Hook configuration has also changed. It is no longer required to include hooks such as verification to get verification working. Instead, verification is enabled globally (selfservice.flows.verification.enabled). Also, the redirect hook has been removed as it lead to confusion because there are already default redirect URLs configurable. You will find more information in the details below.

Session Management

-ttl:
-  session: 1h
-security:
-  session:
-    cookie:
-      same_site: Lax
+session:
+  lifespan: 1h
+  cookie_same_site: Lax

Secrets

-secrets:
-  session:
-    - secret-to-encrypt-session-cookies
-    - old-session-cookie-secret-that-has-been-rotated
+secrets:
+  default:
+    # This secret is used as default and will also be used for encrypting e.g. cookies when a dedicated cookie secret (as shown below) is not defined.
+    - default-secret-to-encrypt-stuff
+  cookie:
+    - secret-to-encrypt-session-cookies
+    - old-session-cookie-secret-that-has-been-rotated

URLs

The Base URL configuration has moved to serve.public and serve.admin. They are also no longer required and fall back to defaults based on the machine's hostname, port configuration, and other settings:

-urls:
-  self:
-    public: https://kratos.my-website.com/
-    admin: https://admin.kratos.cluster.localnet/
+serve:
+  public:
+    base_url: https://kratos.my-website.com/
+  admin:
+    base_url: https://admin.kratos.cluster.localnet/

The UI URLs have moved from urls to their respective self-service flows:

-urls:
-  login_ui: http://127.0.0.1:4455/auth/login
-  registration_ui: http://127.0.0.1:4455/auth/registration
-  settings_ui: http://127.0.0.1:4455/settings
-  verify_ui: http://127.0.0.1:4455/verify
-  error_ui: http://127.0.0.1:4455/error
+selfservice:
+  flows:
+    login:
+      ui_url: http://127.0.0.1:4455/auth/login
+    registration:
+      ui_url: http://127.0.0.1:4455/auth/registration
+    settings:
+      ui_url: http://127.0.0.1:4455/settings
+    # please note that `verify` has changed to `verification`!
+    verification:
+      ui_url: http://127.0.0.1:4455/verify
+    error:
+      ui_url: http://127.0.0.1:4455/error

The default redirect URL as well as whitelisted redirect URLs have also changed their location:

-urls:
-  default_return_to: https://self-service/dashboard
-  whitelisted_return_to_urls:
-    - https://self-service/some-other-url
-    - https://example.org/another-url
+selfservice:
+  default_browser_return_url: https://self-service/dashboard
#  Please note that the `to` has been removed (`whitelisted_return_to_urls` -> `whitelisted_return_urls`)
+  whitelisted_return_urls:
+    - https://self-service/some-other-url
+    - https://example.org/another-url

Self-Service Login

selfservice.login has moved to selfservice.flow.login:

 selfservice:
-  login:
+  flows:
+    login:

On top of this change, a few keys under login have changed as well:

 selfservice
   flows:
     login:
+      ui_url: http://127.0.0.1:4455/auth/login
       request_lifespan: 99m
-      before:
-        hooks:
-          - hook: redirect
-            config:
-              default_redirect_url: http://test.kratos.ory.sh:4000/
-              allow_user_defined_redirect: false
+      # The before hooks have been removed because there were no good use cases for them. If
+      # this is a problem for you feel free to open an issue!

     after:
-      default_return_to: https://self-service/login/return_to
+      default_browser_return_url: https://self-service/login/return_to
       password:
-         default_return_to: https://self-service/login/password/return_to
+         default_browser_return_url: https://self-service/login/password/return_to
          hooks:
            - hook: revoke_active_sessions
       oidc:
-         default_return_to: https://self-service/login/podc/return_to
+         default_browser_return_url: https://self-service/login/podc/return_to
          hooks:
            - hook: revoke_active_sessions

Self-Service Registration

selfservice.registration has moved from to selfservice.flow.registration:

 selfservice:
-  registration:
+  flows:
+    registration:

On top of this change, a few keys under registration have changed as well:

 selfservice
   flows:
     registration:
+      ui_url: http://127.0.0.1:4455/auth/registration
       request_lifespan: 99m
-      before:
-        hooks:
-          - hook: redirect
-            config:
-              default_redirect_url: http://test.kratos.ory.sh:4000/
-              allow_user_defined_redirect: false
+      # The before hooks have been removed because there were no good use cases for them. If
+      # this is a problem for you feel free to open an issue!

     after:
-      default_return_to: https://self-service/registration/return_to
+      default_browser_return_url: https://self-service/registration/return_to
       password:
-        default_return_to: https://self-service/registration/password/return_to
+        default_browser_return_url: https://self-service/registration/password/return_to
         hooks:
           - hook: revoke_active_sessions
+          # The verify hook is now executed automatically when verification is turned on.
-          - hook: verify
+          # The redirect hook was confusing as it aborts the registration flow and does not solve redirection on
+          # success. It has thus been removed.
-          - hook: redirect
       oidc:
-        default_return_to: https://self-service/registration/podc/return_to
+        default_browser_return_url: https://self-service/registration/podc/return_to
         hooks:
           - hook: revoke_active_sessions
+          # The verify hook is now executed automatically when verification is turned on.
-          - hook: verify
+          # The redirect hook was confusing as it aborts the registration flow and does not solve redirection on
+          # success. It has thus been removed.
-          - hook: redirect

Self-Service Settings

selfservice.settings has moved from to selfservice.flow.settings:

 selfservice:
-  settings:
+  flows:
+    settings:

On top of this change, a few keys under settings have changed as well:

 selfservice
   flows:
     settings:
+      ui_url: http://127.0.0.1:4455/settings
       request_lifespan: 99m
       privileged_session_max_age: 99m
-      default_return_to: https://self-service/settings/return_to
       after:
+        default_browser_return_url: https://self-service/settings/return_to
+        # The profile/password after hooks have been removed as verification is now executed automatically
+        # when turned on.
-        password:
-          hooks:
-            - hook: verify
-        profile:
-          hooks:
-            - hook: verify

Self-Service Verification

selfservice.verify has moved from to selfservice.flow.verification:

 selfservice:
-  verify:
+  flows:
+    verification:

Instead of configuring verification with hooks and other components, it can now be enabled in a central place. If enabled, a SMTP server must be configured in the courier section. You are still required to mark a field as verifiable in your Identity JSON Schema.

 selfservice:
   flows:
     verification:
+      enabled: true # defaults to true
+      ui_url: http://127.0.0.1:4455/recovery
       request_lifespan: 1m
-      default_return_to: https://self-service/verification/return_to
       after:
+        default_browser_return_url: https://self-service/verification/return_to

Replaces the update_successful field of the settings request with a field called state which can be either show_form or success.

Flows, request methods, form fields have had a key errors to show e.g. validation errors such as ("not an email address", "incorrect username/password", and so on. The errors key is now called messages. Each message now has a type which can be error or info, an id which can be used to translate messages, a text (which was previously errors[*].message). This affects all login, request, settings, and recovery flows and methods.

To refresh a login session it is now required to append refresh=true instead of prompt=login as the second has implications for revoking an existing issue and might be confusing when used in combination with OpenID Connect.

Applying this patch requires running SQL Migrations.
The field identity.addresses has moved to identity.verifiable_addresses.
Configuration key selfservice.verification.link_lifespan has been merged with selfservice.verification.request_lifespan.

Bug Fixes

Account recovery can't use recovery token (#526) (379f24e), closes #525
Add and document recovery to quickstart (c229c54)
Add pkger to docker builds (d3ef5a0)
Allow linking oidc credentials without existing oidc connection (#548) (39c1234), closes #532
Bump pop version (#558) (9e46cea), closes #556
Clear error messages after updating settings successfully (#421) (7eec388), closes #420
Do not send debug on session/whoami (16d3670), closes #483
Document login refresh parameter in swagger (#482) (6b94993)
Embedded video link properly (#514) (962bbc6)
Embedded video link properly (#515) (821ca93)
Enable recovery for quickstart (0ccc651)
Improve grammar of similar password error (#471) (39873bf)
Improvements to Dockerfiles (#552) (6023877):
- expose ory home as volume to simplify passing in own config file
- declare Kratos default ports in Dockerfile
Initialize verification request with correct state (3264ecf), closes #543
Re-add all databases to persister (#527) (b04d178)
Re-add redirect targets for quickstart (3c48ad2)
Reduce docker bloat by ignoring docs and others (ecc555b)
Resolve broken redirect in verify flow (a9ca8fd), closes #436
Respect multiple secrets and fix used flag (#526) (b16c2b8), closes #525
Respect self-service enabled flag (#470) (b198faf), closes #417:

Respects the enabled flag for self-service strategies.

Also a new testhelper function was needed, to defer route registration (because whether strategies are enabled or not is determined only once: at route registration)
Typo accent -> account (984d978)
Use correct brew replacements (fd269b1), closes #423
Write migration tests (#499) (d32413a), closes #481

Code Generation

Pin v0.4.0-alpha.1 release commit (e8690c4)

Code Refactoring

Improve and simplify configuration (#536) (8e7f9f5), closes #432
Move schema packing to pkger (173f9d2)
Move verify fallback to verification (1ce6469)
Rename identity traits schema to identity schema (#557) (949e743), closes #531
Rename prompt=login to refresh=true (#478) (c04346e), closes #477
Replace settings update_successful with state (#488) (ca3b3f4), closes #449
Text errors to text messages (#476) (8106951), closes #428:

This patch implements a better way to deal with text messages by giving them a unique ID, a context, and a default message.

Documentation

Add azure to next docs (e1dd3fa)
Add fixme note for viper workaround (7e3eef6):

See ory/x#169
Add guide for setting up account recovery (bbf3762)
Add guide for setting up email verification (1435cbc)
Add guide for SSO via Google (#424) (5c45b16)
Add new guides to sidebar (24c5cbc)
Added video tutorials to guides (#513) (956731d)
Added youtube manual (#490) (ec232f7)
Connecting Kratos to AzureAD (#433) (7660bcd)
Correct claims.email in github guide (#422) (052a622):

There is no email_primary in claims, and the selfservice strategy is currently using claims.email.
Correct claims.email in github guide (#422) (58f7e15):

There is no email_primary in claims, and the selfservice strategy is currently using claims.email.
Correct link in user-settings (d13317d)
Correct SDK use in quickstart (#480) (dfdf975), closes #430
Correct stray dot (e820f41)
Correct user settings render form (197e246)
Delete old redirect homepage (b6d9244)
Document new account recovery feature (2252a86), closes #436
Document refresh=true for login (#479) (2ab5ead), closes #464
Embedded quickstart video (#491) (ee80346)
Fix broken link (d20816e)
Fix broken link (aa9d3e6)
Fix broken link (#506) (dac8dfd):

The rest api is no longer under sdk but under reference.
Fix broken link (#554) (e80d691)
Fix code sample comment (781a76b)
Fix copy paste errors in code docs (e456a4e)
Fix iframe syntax (#520) (0cb36ca)
Fix typo (#535) (c57d270)
Fix typo in base docs (#503) (6668048)
Fix typo in oauth sign in documentation (#504) (886e24d)
Fix typos (81903a5)
Fix typos (#489) (57a7bc8)
Fix ui url keys everywhere (b75debb)
Fix username example by renaming property and removing format (#508) (4573426)
Fix wording in settings flow graph (e2a0084)
Fixed broken link (#452) (d1ddbd1)
Fixed broken link (#455) (4f3d179)
Fixed broken link (#456) (4b43e99)
Fixed broken link (#460) (7da304c)
Fixed broken link (#461) (c248e4e)
Fixed broken link (#462) (ceacac3)
Fixed broken links (#451) (193a781):

Fixed a few broken links, .md in the url was the problem.
Fixed broken links (#453) (59d00eb)
Fixed broken links (#457) (00ec00d)
Fixed broken links (#458) (f960887)
Fixed broken links (#459) (2749596)
Fixed broken markdown (#474) (22d5be1)
Format guides (407c70f)
Improve grammar and wording (#448) (a19adf3)
Improve grammar, clarify sections, update images (#419) (79019d1)
Make whitelisted_return_to_urls examples an array (#426) (7ed5605), closes #425
Minor fixes (#467) (8d15307)
Move security questions to own document (2b77fba)
Properly annotate forms disabled field (#486) (be1acb3), closes /github.com/ory/kratos/pull/467#discussion_r434764266
Remove rogue slash and fix closing tag (#521) (3fd1076)
Rename redirect page to browser-redirect-flow-completion (ae77d48)
Replace mailhog references with mailslurper (#509) (d0e5a0f)
Run format (2b3f299)
Typo correction in credentials.md (#551) (3b7e104)
Typos and stale links (29fb466)
Typos and stale links (#510) (7557ab8)
Update repository templates (4c89834)
Use central banner repo for README (d1e8a82)
Use shorthand closing tag for Mermaid (f9f2dbc)

Features

Add support for Multitenant Azure AD as an OIDC provider (#434) (a8f1179)
Add tests for defaults (a16fc51)
Add User ID to a header when calling whoami (#530) (183b4d0)
Implement account recovery (#428) (e169a3e), closes #37:

This patch implements the account recovery with endpoints such as "Init Account Recovery", a new config value urls.recovery_ui and so on. A new identity field has been added identity.recovery_addresses containing all recovery addresses.

Additionally, some refactoring was made to DRY code and make naming consistent. As part of dependency upgrades, structured logging has also improved and an audit trail prototype has been added (currently streams to stderr only).

Unclassified

docs:fixed broken link (#454) (22720c6), closes #454
Allow kratos to talk to databases in docker-compose quickstart (#522) (8bf9a1a):

All of the databases must exist on the same docker network to allow the main kratos applications to communicate with them.
Fixed typo (#472) (31263b6)

0.3.0-alpha.1 (2020-05-15)

This release finalizes the OpenID Connect and OAuth2 login, registration, and settings strategy with JsonNet data transformation! From now on, "Sign in with Google, Github, ..." is officially supported! It's also possible to link and unlink these connections using the Self-Service Settings Flow! The documentation has been updated to reflect those changes and includes guides to setting up "Sign in with GitHub" in under 5 Minutes! Please be aware that existing OpenID Connect connections will stop working. Check out the "Breaking Changes" section for more info! Want to learn more? Check out the docs!

We also changed the config validation output, making it easier than ever to find bugs in your config:

% kratos --config invalid-config.yml serve
INFO[0001] Config file loaded successfully.              path=invalid-config.yml
ERRO[0001] The provided configuration is invalid and could not be loaded. Check the output below to understand why.  config_file=invalid-config.yml

dsn: <nil>
     ^-- one or more required properties are missing

urls.whitelisted_return_to_urls: https://selfservice.office.example.com
                                 ^-- expected array, but got string

FATA[0001] The services failed to start because the configuration is invalid. Check the output above for more details.

This release concludes over 50 commits and 16.000 lines of code changed.

Breaking Changes

If you upgrade and have existing Social Sign In connections, it will no longer be possible to use them to sign in. Because the oidc strategy was undocumented and not officially released we do not provide an upgrade guide. If you run into this issue on a production system you may need to use SQL to change the config of those identities. If this is a real issue for you that you're unable to solve, please create an issue on GitHub.

This is a breaking change as previous OIDC configurations will not work. Please consult the newly written documentation on OpenID Connect to learn how to use OIDC in your login and registration flows. Since the OIDC feature was not publicly broadcasted yet we have chosen not to provide an upgrade path. If you have issues, please reach out on the forums or slack.

Bug Fixes

Access rules of oathkeeper for quick start (#390) (5ed6d05), closes #389:

To access / as dashboard
Active field should not be required (#401) (aed2a5c), closes ory/sdk#14
Adopt jsonnet in e2e oidc tests (5e518fb)
Detect postgres unique constraint (3a777af)
Fix oidc strategy jsonnet test (f6c48bf)
Improve config validation error message (#414) (d1e6896), closes #413
Reset request id after parse (9550205)
Resolve flaky swagger generation (#416) (ac4acfc)
Resolve regression issues and bugs (e6d5369)
Return correct error on id mismatch (5915f28)
Test and implement mapper_url for jsonnet (40ac3dc)
Transaction usage in the identity persister (#404) (7f5072d)

Chores

Pin v0.3.0-alpha.1 release commit (43b693a)

Code Refactoring

Adopt new request parser (ad16cc9)
Dry config and oidc tests (3e98756)
Improve oidc flows and payloads and add e2e tests (#381) (f9a5079), closes #387:

This patch improves the OpenID Connect login and registration user experience by simplifying the network flows and introduces e2e tests using ORY Hydra.
Move cypress files to test/e2e (df8e627)
Moved scanner json to ory/x (#412) (8a0967d)
Partition files and change creds structure (4f1eb94):

This patch changes the data model of the OpenID Connect strategy. Instead of using an array of providers as the base config item (e.g. {"type":"oidc","config":[{"provider":"google","subject":"..."}]}) the credentials config is now an object with a providers key: {"type":"oidc","config":{"providers":[{"provider":"google","subject":"..."}]}}. This change allows introduction of future changes to the schema without breaking compatibility.
Replace oidc jsonschema with jsonnet (2b45e79), closes #380:

This patch replaces the previous methodology of merging OIDC data which used JSON Schema with Extensions and JSON Path in favor of a much easier to use approach with JSONNet.
settings: Use common request parser (ad6c402)

Documentation

Document account enumeration defenses for oidc (266329c), closes #32
Document new oidc jsonnet mapper (#392) (088b30f)
Document oidc strategy (#415) (9f079f4), closes #409 #124 #32
Explain that form data is merged with oidc data (#394) (b0dbec4), closes #127
Fix links in README (efb6102), closes #403
Improve social sign in guide (#393) (647ced3), closes #49:

This patch changes the social sign in guide to represent more use cases such as Google and Facebook. Additionally, the example has been updated to work with Jsonnet.

This patch also documents limitations around merging user data from GitHub.
Improve the identity data model page (#410) (2915b8f)
Include redirect doc in nav (5aaebff), closes #406
Prepare v0.3.0-alpha.1 (d6a6f43)
Ui should show only active form sections (#395) (4db674d)
Update github templates (#408) (6e646b0)

Features

Add format and lint for JSONNet files (0a1b244):

This patch adds two commands kratos jsonnet format and kratos jsonnet lint that help with formatting and linting JSONNet code.
Implement oidc settings e2e tests (919925c)
Introduce leaklog for debugging oidc map payloads (238d7a4)
Write tests and fix bugs for oidc settings (575a61f)

Unclassified

Format code (bc7557a)

0.2.1-alpha.1 (2020-05-05)

Resolves a bug in the kratos-selfservice-ui-node application.

Chores

Pin v0.2.1-alpha.1 release commit (16463ea)

Documentation

Fix quickstart hero sections (7c6c439)
Fix typo in upgrade guide (a1b1d7c)

0.2.0-alpha.2 (2020-05-04)

This is a heavy release with over hundreds of commits and files changed! Let's take a look at some of the highlights!

ORY Oathkeeper now optional

Using ORY Oathkeeper to protect your API is now optional. The basic quickstart now uses a much simpler set up. Go check it out now!

PostgreSQL, MySQL, CockroachDB support now tested and official!

All three databases now pass acceptance tests and are thus officially supported!

Self-Service Profile Flow

The self-service profile flow has been refactored into a more generic flow allowing users to make modifications to their traits and credentials. Check out the docs to learn more about the flow and it's features.

Please keep in mind that the flow's APIs have changed. We recommend re-reading the docs!

Managing Privileged Profile Fields

Flows such as changing ones profile or primary email address should not be possible unless the login session is fresh. This prevents your colleague or evil friend to take over your account while you make yourself a coffee.

ORY Kratos now supports this by redirecting the user to the login screen if changes to sensitive fields are made. The changes will only be applied after successful reauthentication.

Changes to Hooks

This patch focuses on refactoring how self-service flows terminate and changes how hooks behave and when they are executed.

Before this patch, it was not clear whether hooks run before or after an identity is persisted. This caused problems with multiple writes on the HTTP ResponseWriter and other bugs.

This patch removes certain hooks from after login, registration, and profile flows. Per default, these flows now respond with an appropriate payload ( redirect for browsers, JSON for API clients) and deprecate the redirect hook. This patch includes documentation which explains how these hooks work now.

Additionally, the documentation was updated. Especially the sections about hooks have been refactored. The login and user registration docs have been updated to reflect the latest changes as well.

BREAKING CHANGE: Please remove the redirect hook from both login, registration, and settings after configuration. Please remove the session hook from your login after configuration. Hooks have moved down a level and are now configured at selfservice.<login|registration|settings>.<after|before>.hooks instead of selfservice.<login|registration|settings>.<after|before>.hooks. Hooks are now identified by hook: instead of job:. Please rename those sections accordingly.

We recommend re-reading the Hooks Documentation.

Changing Passwords

It's now possible to change your password using the Self-Service Settings Flow! Lean more about this flow here

End-To-End Tests

We added tons of end-to-end and integration tests to find and fix pesky bugs.

Breaking Changes

Please remove the redirect hook from both login, registration, and settings after configuration. Please remove the session hook from your login after configuration. Hooks have moved down a level and are now configured at selfservice.<login|registration|settings>.<after|before>.hooks instead of selfservice.<login|registration|settings>.<after|before>.hooks. Hooks are now identified by hook: instead of job:. Please rename those sections accordingly.

Several profile-related URLs have and payloads been updated. Please consult the most recent documentation.

The payloads of the Profile Management Request API that previously were set in { "methods": { "traits": { ... } }} have now moved to { "methods": { "profile": { ... } }}.

This patch introduces a refactor that is needed for the profile management API to be capable of handling (password, oidc, ...) credential changes as well.

To implement this, the payloads of the Profile Management Request API that previously were set in {"form": {...} } have now moved to {"methods": { "traits": { ... } }}.

In the future, as more credential updates are handled, there will be additional keys in the forms key {"methods": { "traits": { ... }, "password": { ... } }}.

Bug Fixes

Allow setting new password in profile flow (3b5fd5c)
Automatically append multiStatements parameter to mySQL URI (#374) (39f77bb)
config: Rename config key stmp to smtp (#278) (ef95811)
Create pop connection without parsed connection options (#366) (10b6481)
Declare proper vars for setting version (#383) (2fc7556)
Decouple quickstart scenarios (#336) (17363b3), closes #262:

Creates several docker compose examples which include various scenarios of the quickstart.

The regular quickstart guide now works without ORY Oathkeeper and uses the standalone mode of the example app instead.

Additionally, the Makefile was improved and now automatically pulls required dependencies in the appropriate version.
docker: Throw away build artifacts (481ec1b)
Document Schema API and serve over admin endpoint (#299) (4be417c), closes #287
Exempt whomai from csrf protection (#329) (31d4065)
Fix swagger annotation (#331) (5c5c78f):

Closes ory/sdk#10
Move to ory sqa service (#309) (7c244e0)
Properly annotate error API (a6f1300)
Remove unused returnTo (e64e5b0)
Resolve docker build permission issues (f3612e8)
Resolve failing test issues (2e968e5)
Resolve linux install script archive naming (#302) (c98b8aa)
Resolve NULL value for seen_at (#259) (a7d1e86), closes #244:

Previously, errorx tests were not executed which caused several bugs.
Resolve password continuity issues (56a44fa)
Revert use host volume mount for sqlite (#272) (#285) (a7477ab):

This reverts commit 230ab2d83f4d187f410e267c6d68554e82514948.
Self-service error query parameter name (#308) (be257f5):

The query parameter for the self-service errors endpoint was named id in the API docs, whereas it is the error param that is used by the handler.
session: Regenerate CSRF Token on principal change (#290) (1527ef4), closes #217
session: Whoami endpoint now supports all HTTP methods (#283) (4bf645b), closes #270
Show log in ui only when unauthenticated or forced (df77310), closes #323
sql: Rename migrations with same version (#280) (07e46b9), closes #279
swagger: Move nolint,deadcode instructions to own file (#293) (1935510):

Closes ory/docs#279
Use host volume mount for sqlite (#272) (230ab2d)
Use resilient client for HIBP lookup (#288) (735b435), closes #261
Use semver-regex replacer func (d5c9a47)
Use sqlite tag on make install (2c82784)
Verified_at field should not be required (#353) (15d5e26):

Closes ory/sdk#11

Chores

Pin v0.2.0-alpha.2 release commit (ab91689)

Code Refactoring

Move docs to this repository (#317) (aa0d726)
Prepare profile management payloads for credentials (44493f3)
Rename traits method to profile (4f1e033)
Rework hooks and self-service flow completion (#349) (a7c7fef), closes #348 #347 #179 #51 #50 #31:

This patch focuses on refactoring how self-service flows terminate and changes how hooks behave and when they are executed.

Before this patch, it was not clear whether hooks run before or after an identity is persisted. This caused problems with multiple writes on the HTTP ResponseWriter and other bugs.

This patch removes certain hooks from after login, registration, and profile flows. Per default, these flows now respond with an appropriate payload ( redirect for browsers, JSON for API clients) and deprecate the redirect hook. This patch includes documentation which explains how these hooks work now.

Additionally, the documentation was updated. Especially the sections about hooks have been refactored. The login and user registration docs have been updated to reflect the latest changes as well.

Also, some other minor, cosmetic, changes to the documentation have been made.

Documentation

Add banner kratos (8a9dfbb)
Add csrf and cookie debug section (#342) (cac2948), closes #341
Add database connection documentation (#332) (4f9e8b0)
Add HA docs (2e5c591)
Add hook changes to upgrade guide (55b5fe0)
Add info to oidc (#382) (6eeeb5d)
Add more examples to config schema (#372) (ed2ccb9), closes #345
Add quickstart notes for docker debugging (74f082a)
Add settings docs and improve flows (#375) (478cd9c), closes #345
concepts: Fix typo (a49184c):

Closes ory/docs#296
concepts: Properly close code tag (1c841c2)
Declare api frontmatter properly (df7591f)
Document 0.2.0 high-level changes (9be1064)
Document multi-tenant set up (891594d), closes #370
Fix broken images in quickstart (52aa4cf)
Fix broken link (bf7843c), closes #327
Fix broken link (c2adc73), closes #327
Fix broken mermaid links (f24fc1b)
Fix spelling in quickstart (#356) (3ce6b4a)
Improve changelog (#384) (a973ca7)
Improve profile section and restructure nav (#373) (3cc0979), closes #345
Regenerate and update changelog (7d4ed98)
Regenerate and update changelog (175b626)
Regenerate and update changelog (e60e2df)
Regenerate and update changelog (41eeb75)
Regenerate and update changelog (468105a)
Regenerate and update changelog (8414520)
Regenerate and update changelog (85d5866)
Regenerate and update changelog (e8d2d10)
Regenerate and update changelog (4c58b6d)
Regenerate and update changelog (a726eb2)
Regenerate and update changelog (87b47ba)
Regenerate and update changelog (537d496)
Regenerate and update changelog (00e6af9)
Regenerate and update changelog (48a2eca)
Regenerate and update changelog (8a71948)
Regenerate and update changelog (ad3d510)
Regenerate and update changelog (48bcc70)
Regenerate and update changelog (816a55c)
Regenerate and update changelog (4ed74d2)
Regenerate and update changelog (367927e)
Regenerate and update changelog (38f4019)
Typo in README.md (#265) (9f865a2)
Update banner url (292c986)
Update forum and chat links (3039191)
Update github templates (#338) (57dbc77)
Update github templates (#343) (eb13dc1)
Update github templates (#350) (faf2f30)
Update github templates (#351) (20ff289)
Update linux install guide (3b8e549)
Update linux install guide (#354) (ec49cae)
Update self service reg docs (#367) (4cf0323), closes /github.com/ory/kratos-selfservice-ui-node/blob/489c76d1b0474ee55ef56804b28f54d8718747ba/src/routes/auth.ts#L28:

The old links pointed at /auth/browser/(login|registration) which seems to be outdated now.
Update user-settings-profile-management.md (#322) (45dc3a5)
Updates issue and pull request templates (#298) (1be738d)
Updates issue and pull request templates (#313) (299063c)
Updates issue and pull request templates (#314) (d5ae452)
Updates issue and pull request templates (#315) (8b68db1)
Use git checkout in quickstart (#339) (2d2562b), closes #335

Features

Add dsn: memory shorthand (#284) (e66a030), closes #228
Add and test id hint in reauth flow (2298f01), closes #323
Add cypress e2e tests (#334) (abc0e91)
Allow configuring same-site for session cookies (#303) (2eb2054), closes #257:

It is now possible to set SameSite for the session cookie via the key security.session.cookie.same_site.
continuity: Implement request continuity (135e047), closes #304 #311:

This patch adds a module which is capable of aborting a request, waiting for another option to complete, and then resuming the request again.

This feature makes use of a temporary cookie which keeps track of the request state.

This feature is required for several workflows that update privileged fields such as passwords, 2fa recovery codes, email addresses.

refactor: rename profile to settings flow

Renames selfservice/profile to settings. The settings flow includes a strategy for managing profile information
Enable CockroachDB integration (#260) (adc5153), closes #132 #155
Enable continuity management for settings module (009d755)
Enable updating auth related traits (#266) (65b88ba), closes #243
Implement password profile management flow (a31839a), closes #243
Introduce fallbacks for required configs (#376) (b3bcb25), closes #369 #352
login: Forced reauthentication (#248) (344fc9c), closes #243
Return 410 when selfservice requests expire (#289) (b414607), closes #235
Send verification emails on profile update (#333) (1cacc80), closes #267

Unclassified

u (0b6fa48)
u (03fa4f0)
u (a3dfd9d)
u (616aa0f)
fix:add graceful shutdown to courier handler (#296) (235d784), closes #296 #295:

Courier would not stop with the provided Background handler. This changes the methods of Courier so that the graceful package can be used in the same way as the http endpoints can be used.
fix(sql) change courier body to text field (#276) (ed5268d), closes #276 #269
Make format (b85e5af)

0.1.1-alpha.1 (2020-02-18)

docs: Regenerate and update changelog

Bug Fixes

Add verify return to address (#252) (64ab9e5)
Clean up docker quickstart (#255) (7f0996b)
Resolve several verification problems (#253) (30d4632)
Update verify URLs (#258) (5d4f909)

Code Refactoring

Support context-based SQL transactions (#254) (6ace1ee)

Documentation

Regenerate and update changelog (a125822)
Regenerate and update changelog (b3a8220)
Regenerate and update changelog (a141b30)
Regenerate and update changelog (7e12e20)
Regenerate and update changelog (3c1c67b)
Regenerate and update changelog (ee07937)

0.1.0-alpha.6 (2020-02-16)

feat: Add verification to quickstart (#251)

Bug Fixes

Adapt quickstart to verify changes (#247) (24eceb7)
Gracefully handle selfservice request expiry (#242) (4421e6b), closes #233
Set AuthenticatedAt in session issuer hook (#246) (29c83fa), closes #224
swagger: Sanitize before validate (c72f140)
swagger: Use correct annotations for request methods (#237) (8473c85), closes #234

Code Refactoring

Move to ory/jsonschema/v3 everywhere (#229) (61f5c1d), closes #225

Documentation

Regenerate and update changelog (922cf0f)
Regenerate and update changelog (e097c23)
Regenerate and update changelog (2d1685f)
Regenerate and update changelog (f8964e9)
Regenerate and update changelog (92b8001)
Regenerate and update changelog (d7083ab)
Regenerate and update changelog (c4547dc)
Regenerate and update changelog (d8d8bba)
Regenerate and update changelog (b012ed9)

Features

Add disabled flag to identifier form fields (#238) (a2178bd), closes #227
Add verification to quickstart (#251) (172dc87)
Implement email verification (#245) (eed00f4), closes #27
Improve password validation strategy (#231) (256fad3)

0.1.0-alpha.5 (2020-02-06)

docs: Regenerate and update changelog

Documentation

Regenerate and update changelog (e87e9c9)
Regenerate and update changelog (d6f0794)
Regenerate and update changelog (eb7326c)

Features

Redirect to new auth session on expired auth sessions (#230) (b477ecd), closes #96

0.1.0-alpha.4 (2020-02-06)

ci: Bump ory/sdk to 0.1.22

Continuous Integration

Bump ory/sdk to 0.1.22 (c0d0edf)

Documentation

Regenerate and update changelog (f02afb3)

0.1.0-alpha.3 (2020-02-06)

ci: Bump ory/sdk orb

Continuous Integration

Bump ory/sdk orb (65b2ca0)

0.1.0-alpha.2 (2020-02-03)

docs: Regenerate and update changelog

Bug Fixes

Add paths to sqa middleware (#216) (130c9c2)
daemon: Register error routes on admin port (#226) (decd8d8)
Set csrf token on public endpoints (d0b15ae)

Documentation

Introduce upgrade guide (736a3b1)
Prepare ecosystem automation (7013b6c)
Regenerate and update changelog (f39b942)
Regenerate and update changelog (c121601)
Regenerate and update changelog (a947d55)
Regenerate and update changelog (8ba2044)
Regenerate and update changelog (9c023e1)
Regenerate and update changelog (1e855a9)
Regenerate and update changelog (01ce3a8)
Updates issue and pull request templates (#222) (4daae88)

Features

Override semantic config (#220) (9b4214b)

Unclassified

Update CHANGELOG [ci skip] (ce9390c)
refactor!: Improve user-facing error APIs (#219) (7d4054f), closes #219 #204:

This patch refactors user-facing error APIs:
- The /errors endpoint moved to /self-service/errors
- The endpoint is now available at both the Admin and Public API. The Public API requires CSRF Token match or a 403 error will be returned.
- The Public API endpoint no longer returns 404 errors but 403 instead.
- The response payload changed. What was [{"code": ...}] is now {"id": "...", "errors": [{"code": ...}]}
This patch requires running kratos migrate sql as a new column (csrf_token) has been added to the user-facing error store.
Update CHANGELOG [ci skip] (c368a11)

0.1.0-alpha.1 (2020-01-31)

docs: Updates issue and pull request templates (#215)

Signed-off-by: aeneasr aeneas@ory.sh

Documentation

Updates issue and pull request templates (#215) (10c45f2)

0.0.3-alpha.15 (2020-01-31)

Update permissions in SQLite Dockerfile

Unclassified

Update permissions in SQLite Dockerfile (1266e53)

0.0.3-alpha.14 (2020-01-31)

Update README.md

Unclassified

Update README.md (db8d65b)

0.0.3-alpha.13 (2020-01-31)

Allow mounting SQLite in /home/ory/sqlite (#212)

Unclassified

Allow mounting SQLite in /home/ory/sqlite (#212) (2fe8c0f), closes #212

0.0.3-alpha.11 (2020-01-31)

Clean up cmd and resolve packr2 issues (#211)

This patch addresses issues with the build pipeline caused by an invalid import. Profiling was also added.

Unclassified

Clean up cmd and resolve packr2 issues (#211) (2e43ec0), closes #211:

This patch addresses issues with the build pipeline caused by an invalid import. Profiling was also added.
Improve field types (#209) (aeefa93), closes #209
Update CHANGELOG [ci skip] (fc32207)

0.0.3-alpha.10 (2020-01-31)

Update README

Unclassified

Update README (35a310d)
Update CHANGELOG [ci skip] (3c98745)
Update CHANGELOG [ci skip] (c1c01df)

0.0.3-alpha.7 (2020-01-30)

Use correct project root in Dockerfile

Unclassified

Use correct project root in Dockerfile (3528758)
Update CHANGELOG [ci skip] (e78bbbe)

0.0.3-alpha.5 (2020-01-30)

ci: Resolve final docker build issues (#210)

Continuous Integration

Resolve final docker build issues (#210) (d703a1e)

Unclassified

Update CHANGELOG [ci skip] (ebb1744)
Add libmusl to binary output (e9b8445)

0.0.3-alpha.4 (2020-01-30)

Update CHANGELOG [ci skip]

Unclassified

Update CHANGELOG [ci skip] (018c229)
Add and use ory docker user (cccbe09)
Update CHANGELOG [ci skip] (0e436e5)
Update goreleaser changelog filters (7e5af97)
Update CHANGELOG [ci skip] (4387503)

0.0.3-alpha.2 (2020-01-30)

Resolve goreleaser build issues (#208)

Unclassified

Resolve goreleaser build issues (#208) (d59a08a), closes #208

0.0.3-alpha.1 (2020-01-30)

Update CHANGELOG [ci skip]

Unclassified

Update CHANGELOG [ci skip] (49e09ea)
Take form field orders from JSON Schema (#205) (a880f0d), closes #205 #176
Update CHANGELOG [ci skip] (ff52bbb)
Adapt quickstart docker compose config (#207) (e532583), closes #207
Update CHANGELOG [ci skip] (7f4800b)
Update CHANGELOG [ci skip] (1b2c3f6)
Rework public and admin fetch strategy (#203) (99aa169), closes #203 #122
Update CHANGELOG [ci skip] (1cea427)
ss/profile: Use request ID as query param everywhere (#202) (ed32b14), closes #202 #190
Update CHANGELOG [ci skip] (a392027)
Update HTTP routes for a consistent API naming (#199) (9ed4bda), closes #199 #195

0.0.1-alpha.9 (2020-01-29)

ci: Bump goreleaser orb

Continuous Integration

Bump goreleaser orb (29cd754)

0.0.2-alpha.1 (2020-01-29)

Use correct build archive for homebrew

Unclassified

Use correct build archive for homebrew (74ac29f)

0.0.1-alpha.6 (2020-01-29)

ci: Bump goreleaser orb

Continuous Integration

Bump goreleaser orb (018c94c)

0.0.1-alpha.5 (2020-01-29)

ci: Bump goreleaser dependency

Continuous Integration

Bump goreleaser dependency (ec49bfb)

Unclassified

Resolve build issues with CGO (#196) (298f4ea), closes #196
ss/password: Make form fields an array (#197) (6cb0058), closes #197 #186

0.0.1-alpha.3 (2020-01-28)

ci: Only compile goarmv7

Continuous Integration

Only compile goarmv7 (d8e7ec7)

Documentation

Present ORY Hive to the world (#107) (7883589)
Updates issue and pull request templates (0441dff)
Updates issue and pull request templates (#174) (ad405e9)
Updates issue and pull request templates (#39) (daf5aa8)
Updates issue and pull request templates (#40) (f5907f3)
Updates issue and pull request templates (#59) (8c5612c)
Updates issue and pull request templates (#7) (a1220ba)
Updates issue and pull request templates (#8) (c56798a)

Unclassified

Remove redundant return statement (7c2989f)
ss/oidc: Remove obsolete request field from form (#193) (59671ba), closes #193 #180
strategy/oidc: Allow multiple OIDC Connections (#191) (8984831), closes #191 #114
Improve Docker Compose Quickstart (#187) (9459072), closes #187 #188
selfservice/password: Remove request field and ensure method is set (#183) (e035adc), closes #183
Add tests and fixtures for the config JSON Schema (#171) (ede9c0e), closes #171
Add example values for config JSON Schema (12ba728)
Replace url with uri format in config JSON Schema (68eddef)
Replace number with integer in config JSON Schema (#177) (9eff6fd), closes #177
Improve --dev flag (#167) (9b61ee1), closes #167 #162
Add goreleaser orb task (#170) (5df0def), closes #170
Add changelog generation task (#169) (edd937c), closes #169
Adopt new SDK pipeline (#168) (21d9b6d), closes #168
Add docker-compose quickstart (#153) (e096190), closes #153
Update README (#160) (533775b), closes #160
Separate post register/login hooks (#150) (f4b7812), closes #150 #149
Update README badges (4f7838e)
Bump go-acc and resolve test issues (#154) (15b1b63), closes #154 #152 #151:

Due to a bug in go-acc, tests would not run if -tags sqlite was supplied as a go tool argument to go-acc. This patch resolves that issue and also includes several test patches from previous community PRs and some internal test issues.
Add ORY Kratos banner to README (#145) (23b824f), closes #145
Replace DBAL layer with gobuffalo/pop (#130) (21d08b8), closes #130:

This is a major refactoring of the internal DBAL. After a successful proof of concept and evaluation of gobuffalo/pop, we believe this to be the best DBAL for Go at the moment. It abstracts a lot of boilerplate code away.

As with all sophisticated DBALs, pop too has its quirks. There are several issues that have been discovered during testing and adoption: gobuffalo/pop#136 gobuffalo/pop#476 gobuffalo/pop#473 gobuffalo/pop#469 gobuffalo/pop#466

However, the upside of moving much of the hard database/sql plumbing into another library cleans up the code base significantly and reduces complexity.

As part of this change, the "ephermal" DBAL ("in memory") will be removed and sqlite will be used instead. This further reduces complexity of the code base and code-duplication.

To support sqlite, CGO is required, which means that we need to run tests with go test -tags sqlite on a machine that has g++ installed. This also means that we need a Docker Image with alpine as opposed to pure scratch. While this is certainly a downside, the upside of less maintenance and "free" support for SQLite, PostgreSQL, MySQL, and CockroachDB simply outweighs any downsides that come with CGO.
Replace local deps with remote ones (8605e45)
ss/profile: Improve success and error flows (9e0015a), closes #112:

This patch completes the profile management flow by implementing proper error and success states and adding several data integrity tests.
Rebrand ORY Hive to ORY Kratos (#111) (ceda7fb), closes #111
Fix broken tests and ci linter issues (#104) (69760fe), closes #104
Update to Go modules 1.13 (1da4d75)
Resolve minor configuration issues and response errors (#85) (a44913b), closes #85
Clean up dead files (#84) (e0c96ef), closes #84
Add health endpoints (#83) (0e936f7), closes #83 #82
Update Dockerfile and related build tools (#80) (d20c701), closes #80
Implement SQL Database adapter (#79) (86d07c4), closes #79 #69
Prevent duplicate signups (#76) (4c88968), closes #76 #46
Contributing 08 10 19 00 52 45 (#74) (43b511f), closes #74
Echo form values from oidc signup (98b1da5), closes #71
Properly decode values in error handler (5eb9088), closes #71
Force path and domain on CSRF cookie (#70) (a80d8b0), closes #70 #68
Require no session when accessing login or sign up (#67) (c0e0da1), closes #67 #63
Add tests for selfservice ErrorHandler (#62) (4bb9e70), closes #62
Enable Circle CI (#57) (6fb0afd), closes #57 #53
OIDC provider selfservice data enrichment (#56) (936970a), closes #56 #23 #55
Remove local jsonschema module override (cd2a5d8)
Implement identity management, login, and registration (#22) (bf3395e), closes #22
Revert incorrect license changes (fb9740b)
Create FUNDING.yml (3c67ac8)
Initial commit (ab6f24a)
Add ability to define multiple schemas and serve them over HTTP (#164) (c65119c), closes #86:

All identity traits schemas have to be configured using a human readable ID and the corresponding URL. This PR enables multiple schemas to be used next to the default schema. It also adds the kratos.public/schemas/:id endpoint that mirrors all schemas.
Add helper for requiring authentication (3888fbd)
Add helpers for go-swagger (165a660):

See go-swagger/go-swagger#2119
Add profile management and refactor internals (3ec9263), closes #112
Add session destroyer hook (#148) (d17f002), closes #139:

This patch adds a hook that destroys all active session by the identity which is being logged in. This can be useful in scenarios where only one session should be active at any given time.
Add SQL adapter (#100) (9e7f998), closes #92
Explicitly whitelist form parser keys (#105) (28b056e), closes #98:

Previously the form parser would try to detect the field type by asserting types for the whole form. That caused passwords containing only numbers to fail to unmarshal into a string value.

This patch resolves that issue by introducing a prefix option to the BodyParser
Fix broken import (308aa13)
Handle securecookie errors appropriately (#101) (75bf6fe), closes #97:

Previously, IsNotAuthenticated would not handle securecookie errors appropriately. This has been resolved.
Implement CRUD for identities (#60) (58a3c24), closes #58
Implement message templates and SMTP delivery (#146) (dc674bf), closes #99:

This patch adds a message templates (with override capabilities) and SMTP delivery.

Integration tests using MailHog test fault resilience and e2e email delivery.

This system is designed to be extended for SMS and other use cases.
Improve migration command (#94) (2b631de)
Inject Identity Traits JSON Schema (3a4c5ad), closes #189
Mark active field as nullable (#89) (292702d)
Move package to selfservice (063b767):

Because this module is primarily used in selfservice scenarios, it has been moved to the selfservice parent.
Omit request header from login/registration request (#106) (9b07587), closes #95:

When fetching a login and registration request, the HTTP Request Headers must not be included in the response, as they contain irrelevant information for the API caller.
Properly handle empty credentials config in sql (#93) (b79c5d1)
Re-introduce migration plans to CLI command (#192) (bb32cd3), closes #131
Reset CSRF token on principal change (#64) (9c889ab), closes #38:

Add tests for logout.
Resolve wrong column reference in sql (#90) (0c0eb87):

Reference ic.method instead of ici.method.

Added regression tests against this particular issue.
Update keyword from kratos to ory.sh/kratos (f45cbe0), closes #115
Update sdk generation method (24aa3d7)
Update to ory/x 0.0.80 (#110) (64de2f8):

Removes the need for BindEnv()
Use JSON Schema to type assert form body (#116) (1944c7c), closes #109

Provide feedback

Saved searches

Use saved searches to filter your results more quickly