mirror of
https://github.com/logto-io/logto.git
synced 2024-12-16 20:26:19 -05:00
130 lines
8.4 KiB
Markdown
130 lines
8.4 KiB
Markdown
<p align="center">
|
||
<a href="https://logto.io/?utm_source=github&utm_medium=readme" target="_blank" align="center" alt="Go to Logto website">
|
||
<picture>
|
||
<source width="200" media="(prefers-color-scheme: dark)" srcset="https://github.com/logto-io/.github/raw/master/profile/logto-logo-dark.svg">
|
||
<source width="200" media="(prefers-color-scheme: light)" srcset="https://github.com/logto-io/.github/raw/master/profile/logto-logo-light.svg">
|
||
<img width="200" src="https://github.com/logto-io/logto/raw/master/logo.png" alt="Logto logo">
|
||
</picture>
|
||
</a>
|
||
</p>
|
||
|
||
[](https://discord.gg/vRvwuwgpVX)
|
||
[](https://github.com/logto-io/logto/actions?query=branch%3Amaster)
|
||
[](https://github.com/logto-io/logto/releases)
|
||
[](https://app.codecov.io/gh/logto-io/logto)
|
||
[](https://cloud.logto.io/?sign_up=true&utm_source=github&utm_medium=repo_logto)
|
||
[](https://gitpod.io/#https://github.com/logto-io/demo)
|
||
[](https://render.com/deploy?repo=https://github.com/logto-io/logto)
|
||
|
||
# Logto
|
||
|
||
Logto[^info] is an open-source Identity and Access Management (IAM) platform designed to streamline Customer Identity and Access Management (CIAM) and Workforce Identity Management. With Single Sign-On (SSO), OIDC-based authentication, and Multi-Tenant SaaS capabilities, Logto offers a scalable, secure, and developer-friendly way to manage authentication for modern web and mobile application
|
||
|
||
## Getting started
|
||
- [Join now](https://discord.gg/vRvwuwgpVX) the 💬 [Logto Discord server](https://discord.gg/vRvwuwgpVX) and connect with developers! Get real-time support, share ideas, and stay updated on all things identity management.
|
||
- Deploy today by [registering now](https://auth.logto.io/register) for a free, full featured development tenant
|
||
- Follow the [quick start](https://logto.io/quick-starts/?utm_source=github&utm_medium=repo_logto) guide to begin managing authentication efficiently.
|
||
- Check out our [📖 integrations](https://docs.logto.io/integrations?utm_source=github&utm_medium=repo_logto) to start integrating Logto with your application today.
|
||
- A step-by-step getting started is available on 📖 [Logto docs](https://docs.logto.io/docs/get-started/welcome/?utm_source=github&utm_medium=repo_logto).
|
||
- Visit 🎨 [Logto webstie](https://logto.io/?utm_source=github&utm_medium=repo_logto) for a brief introduction if you are new to Logto.
|
||
|
||
> [!IMPORTANT]
|
||
> [Subscribe now](https://logto.io/subscribe/?utm_source=github&utm_medium=repo_logto) to stay updated with the latest information about the Logto and receive feature updates in real-time.
|
||
|
||
## Key features
|
||
|
||
### 🧑💻 Comprehensive frontend-to-backend identity solution
|
||
|
||
- Enables OpenID Connect (OIDC) based authentication with Logto SDKs.
|
||
- Supports passwordless sign-in, along with various options like email, phone number, username, Google, Facebook, and other social sign-in methods.
|
||
- Offers beautiful UI components with customizable CSS to suit your business needs.
|
||
|
||
### 📦 Out-of-the-box infrastructure
|
||
|
||
- Includes a ready-to-use [Management API](https://openapi.logto.io/), serving as your authentication provider, thus eliminating the need for extra implementation.
|
||
- Provides SDKs that seamlessly integrate your apps with Logto across multiple platforms and languages, tailored to your development environment.
|
||
- Offers flexible connectors that can be scaled with community contributions and customized with SAML, OAuth, and OIDC protocols.
|
||
|
||
### 💻 Enterprise-ready solutions
|
||
|
||
- Implements [role-based access control (RBAC)](https://docs.logto.io/docs/recipes/rbac/) for scalable authorization.
|
||
- Enables user management with [audit logs](https://docs.logto.io/docs/recipes/inspect-audit-logs/) to track identity-related activities and maintain security.
|
||
- Enables [single sign-on (SSO)](https://docs.logto.io/docs/recipes/single-sign-on/) and [multi-factor authentication (MFA)](https://docs.logto.io/docs/recipes/multi-factor-auth/) without minimal coding.
|
||
- Leverage [Logto organizations](https://docs.logto.io/docs/recipes/organizations/understand-how-it-works/) to build [multi-tenancy](https://blog.logto.io/tenancy-models/) apps with ease.
|
||
|
||
## Customer Identity Access Management (CIAM) introductory courses
|
||
For a more approachable introduction, check out Logto’s ***Customer Identity Access Management (CIAM) introductory courses***:
|
||
- [CIAM 101](https://blog.logto.io/ciam-101-intro-authn-sso/): Authentication, Identity, Single sign-on (SSO)
|
||
- [CIAM 102](https://blog.logto.io/ciam-102-authz-and-rbac/): Authorization & Role-based Access Control
|
||
|
||
## Deep dives
|
||
For a ***deeper understanding*** of key identity management topics, explore our [blog](https://blog.logto.io/):
|
||
- [Understanding token exchange in OAuth/OIDC](https://blog.logto.io/token-exchange)– Learn about token-based authentication systems.
|
||
- [Opaque token vs JWT](https://blog.logto.io/opaque-token-vs-jwt) – Discover the differences between token types for authentication.
|
||
- [When should I use JWTs?](https://blog.logto.io/when-should-i-use-jwts) – A guide on when to use JSON Web Token (JWT) for secure authentication.
|
||
- [Bring your own sign-in UI](https://blog.logto.io/bring-your-own-ui)– Customize your user interface (UI) with Logto Cloud for flexible authentication.
|
||
|
||
## Launch Logto today
|
||
### Interactive demo
|
||
|
||
- Try [Logto Cloud](https://cloud.logto.io/?sign_up=true&utm_source=github&utm_medium=repo_logto) to have the same dev experience and zero deployment overhead.
|
||
|
||
- If you're launching Logto [via GitPod](https://gitpod.io/#https://github.com/logto-io/demo), please wait for the message `App is running at https://3002-...gitpod.io` to appear in the terminal, press Command (**CMD**) on macOS or Ctrl on Windows, then click the URL starting with `https://3002-` to continue your Logto journey.
|
||
|
||
### Docker Compose
|
||
|
||
Docker Compose CLI usually comes with [Docker Desktop](https://www.docker.com/products/docker-desktop).
|
||
|
||
```bash
|
||
curl -fsSL https://raw.githubusercontent.com/logto-io/logto/HEAD/docker-compose.yml | \
|
||
docker compose -p logto -f - up
|
||
```
|
||
|
||
### npm-init
|
||
|
||
Requires [Node.js](https://nodejs.org/) `^20.9.0` + [PostgreSQL](https://postgresql.org/) `^14.0`.
|
||
|
||
```bash
|
||
npm init @logto
|
||
```
|
||
|
||
## Language support
|
||
|
||
```ts
|
||
const languages = ['Deutsch', 'English', 'Español', 'Français', 'Italiano', '日本語', '한국어', 'Polski', 'Português', 'Русский', 'Türkçe', '简体中文', '繁體中文'];
|
||
```
|
||
|
||
## Web compatibility
|
||
|
||
Logto uses the [default browserslist config](https://github.com/browserslist/browserslist#full-list) to compile frontend projects, which is:
|
||
|
||
```
|
||
> 0.5%, last 2 versions, Firefox ESR, not dead
|
||
```
|
||
|
||
## Bug report, feature request, feedback
|
||
|
||
- Our team takes security seriously, especially when it relates to identity. If you find any existing or potential security issues, please do not hesitate to email 🔒 [security@logto.io](mailto:security@logto.io).
|
||
- About other bug reports, feature requests, and feedback, you can:
|
||
- Directly 🙋 [open an issue](https://github.com/logto-io/logto/issues/new) on GitHub;
|
||
- 💬 [Join our Discord server](https://discord.gg/vRvwuwgpVX) to have a live chat.
|
||
|
||
## Licensing
|
||
|
||
[MPL-2.0](LICENSE).
|
||
|
||
## Contributing
|
||
|
||
We have a [contributing guideline](https://github.com/logto-io/logto/blob/master/.github/CONTRIBUTING.md) available. Feel free to [contact us](https://logto.io/contact) before coding.
|
||
|
||
## Contact us
|
||
|
||
**Have questions or need support?** We’re here to help! Reach out to our team anytime. If you need assistance or have inquiries about Logto, [Contact Us](https://logto.io/contact), and we’ll make sure you have everything you need to succeed.
|
||
|
||
## Resources
|
||
- [📚 Logto docs](https://docs.logto.io/?utm_source=github&utm_medium=repo_logto)
|
||
- [📝 Logto blog](https://blog.logto.io/?utm_source=github&utm_medium=repo_logto)
|
||
- [🔗 Logto API](https://openapi.logto.io/?utm_source=github&utm_medium=repo_logto)
|
||
- Check out our [awesome list](./AWESOME.md) of community-contributed resources.
|
||
|
||
[^info]: Designed by Silverhand Inc.
|