kratos README

The project's README from github.com/ory/kratos. As one markdown file: README.md.

Ory Kratos - Cloud native identity and user management

Chat · Discussions · Newsletter · Docs · Try Ory Network · Jobs

Ory Kratos is an API first identity and user management system for cloud native applications. It centralizes login, registration, recovery, verification, and profile management flows so your services consume them instead of reimplementing them.

Table of contents

What is Ory Kratos?

Ory Kratos is an API first identity and user management system that follows cloud architecture best practices. It focuses on core identity workflows that almost every application needs:

We recommend starting with the Ory Kratos introduction docs to learn more about its architecture, feature set, and how it compares to other systems.

Why Ory Kratos

Ory Kratos is designed to:

Migrating from Auth0, Okta, and similar providers

If you are migrating from Auth0, Okta, or another identity provider that uses OAuth2 / OpenID Connect based login, consider using Ory Hydra + Ory Kratos together:

This combination is often a drop-in replacement for OAuth2 and OpenID Connect capabilities at the protocol level. In practice, you update client configuration and endpoints to point to Hydra, migrate identities into Kratos, and keep your applications speaking the same OAuth2 / OIDC protocols they already use.

Deployment options

You can run Ory Kratos in two main ways:

Use Ory Kratos on the Ory Network

The Ory Network is the fastest way to use Ory services in production. Ory Identities is powered by the open source Ory Kratos server and is API compatible.

The Ory Network provides:

Sign up for a free developer account to get started.

Self-host Ory Kratos

You can run Ory Kratos yourself for full control over infrastructure, deployment, and customization.

The install guide explains how to:

This guide uses the open source distribution to get you started without license requirements. It is a great fit for individuals, researchers, hackers, and companies that want to experiment, prototype, or run unimportant workloads without SLAs. You get the full core engine, and you are free to inspect, extend, and build it from source.

If you run Kratos as part of a business-critical system, for example login and account recovery for all your users, you should use a commercial agreement to reduce operational and security risk. The Ory Enterprise License (OEL) layers on top of self-hosted Kratos and provides:

For guaranteed CVE fixes, current enterprise builds, advanced features, and support in production, you need a valid Ory Enterprise License and access to the Ory Enterprise Docker registry. To learn more, contact the Ory team.

Quickstart

Install the Ory CLI and create a new project to try Ory Identities.

# Install the Ory CLI if you do not have it yet:
bash <(curl https://raw.githubusercontent.com/ory/meta/master/install.sh) -b . ory
sudo mv ./ory /usr/local/bin/

# Sign in or sign up
ory auth

# Create a new project
ory create project --create-workspace "Ory Open Source" --name "GitHub Quickstart"  --use-project
ory open ax login

Who is using it?

The Ory community stands on the shoulders of individuals, companies, and maintainers. The Ory team thanks everyone involved - from submitting bug reports and feature requests, to contributing patches and documentation. The Ory community counts more than 50.000 members and is growing. The Ory stack protects 7.000.000.000+ API requests every day across thousands of companies. None of this would have been possible without each and everyone of you!

The following list represents companies that have accompanied us along the way and that have made outstanding contributions to our ecosystem. If you think that your company deserves a spot here, reach out to [email protected] now!

Name Logo Website Case Study
OpenAI OpenAI openai.com OpenAI Case Study
Fandom Fandom fandom.com Fandom Case Study
Lumin Lumin luminpdf.com Lumin Case Study
Sencrop Sencrop sencrop.com Sencrop Case Study
OSINT Industries OSINT Industries osint.industries OSINT Industries Case Study
HGV HGV hgv.it HGV Case Study
Maxroll Maxroll maxroll.gg Maxroll Case Study
Zezam Zezam zezam.io Zezam Case Study
T.RowePrice T.RowePrice troweprice.com
Mistral Mistral mistral.ai
Axel Springer Axel Springer axelspringer.com
Hemnet Hemnet hemnet.se
Cisco Cisco cisco.com
Presidencia de la República Dominicana Presidencia de la República Dominicana presidencia.gob.do
Moonpig Moonpig moonpig.com
Booster Booster choosebooster.com
Zaptec Zaptec zaptec.com
Klarna Klarna klarna.com
Raspberry PI Foundation Raspberry PI Foundation raspberrypi.org
Tulip Tulip Retail tulip.com
Hootsuite Hootsuite hootsuite.com
Segment Segment segment.com
Arduino Arduino arduino.cc
Sainsbury's Sainsbury's sainsburys.co.uk
Contraste Contraste contraste.com
inMusic InMusic inmusicbrands.com
Buhta Buhta buhta.com
Amplitude amplitude.com amplitude.com
TIER IV Kyma Project Serlo Padis
Cloudbear Security Onion Solutions Factly All My Funds
Nortal OrderMyGear R2Devops Paralus
dyrector.io pinniped.dev pvotal.tech

Many thanks to all individual contributors

kratos (ory/kratos)

Searching Database…

13.9K ·GitHub
这是做什么用的?一个开源、API 优先的身份和用户管理服务器,面向云原生应用:它把登录、注册、找回密码、验证和个人资料管理集中在一起,这样你的应用就不用自己重新实现这些功能。
我是把 Kratos 引入到我的应用里,还是把它作为一个单独的服务来运行?你需要把它作为一个独立的服务器运行,然后通过 HTTP API 调用它——它是无界面的(headless),通过浏览器和原生应用的流程适配任何 UI 框架,而不是自带现成的界面组件。
我怎么把它跑起来?最快的方式:安装 Ory CLI 并创建一个新项目。如果要自托管,可以在 Linux、macOS、Windows 或 Docker 上安装,配置好数据库,然后部署到 Kubernetes 或从源码构建。
除了服务器本身,它还需要什么才能运行?需要一个数据库:PostgreSQL、MySQL 或 CockroachDB。它是一个用 Go 编写的服务器,可以在 Docker 或 Kubernetes 中运行;从源码构建则需要 Go 和 Make。
免费的开源版本缺少什么?Apache-2.0 许可的核心引擎是完整的,但 SCIM、SAML、组织级 SSO、验证码以及带 SLA 保障的 CVE 补丁都需要付费的 Ory Enterprise License——README 建议对业务关键的登录系统采用该授权。
我用户的身份数据存在哪里?自托管时,数据存在你自己的数据库里,完全由你掌控。托管的 Ory Network 则提供符合 GDPR 要求的存储,在数据本地化和合规方面都有考虑。
我必须自己搭建登录界面吗?自托管 Kratos 的话,是的——它是无界面的(headless),通过浏览器和原生应用的流程适配任何 UI 框架。如果不想做这部分工作,托管的 Ory Network 提供了现成的登录、注册和账户管理页面及组件。
免费的自托管版本能用于生产环境吗?可以——你在 Apache-2.0 许可下获得完整的核心引擎,没有任何许可要求,README 中列出了 Klarna 和 Cisco 等生产环境用户。但对于业务关键的系统,它仍建议签订商业协议,以获得带 SLA 的安全更新和企业级功能。
为什么迁移指南里提到了 Ory Hydra?Kratos 负责身份、凭证和面向用户的流程,而 Hydra 是签发令牌的 OAuth2 和 OpenID Connect 提供方。替换 Auth0 或 Okta 这样的身份提供商(IdP),通常意味着两者一起运行,并把你的应用指向 Hydra。
What are similar projects?zitadel, hydra, dex, casdoor, django-allauth, keycloak, authelia, logto
Creator
ory
Size
96.1 MB
Stars
13.9K
Age
8y
Commits · 90 Days