Coherence：Phoenix框架的全面可配置认证系统

Coherence：Phoenix框架的全面可配置认证系统

coherence Coherence is a full featured, configurable authentication system for Phoenix 项目地址: https://gitcode.com/gh_mirrors/co/coherence

项目介绍

Coherence 是一个功能齐全且高度可配置的认证解决方案，专为 Phoenix 框架设计。它包括一系列模块，如数据库验证、邀请制注册、自助注册、邮件确认、密码重置、登录追踪、账户锁定与解锁等，以满足不同应用场景下的认证需求。通过灵活配置，您可以选择性启用所需的功能，并享受到自动生成的模板和视图，这些资源依据您在安装过程中指定的选项被添加到您的项目结构中。

项目快速启动

添加依赖

首先，确保在您的 mix.exs 文件中的依赖项里加入 Coherence：

defp deps do
  [
    {:coherence, "~> 0.8"}
  ]
end

接下来，在您的应用配置文件 config/config.exs 中配置 Coherence，并确保应用在启动前加载：

def application do
  [extra_applications: [:coherence]]
end

安装 Coherence 及其必要模块，例如进行全功能安装（除确认功能外）:

mix coh.install --full-invitable

这个命令将会生成必要的模型、迁移文件、视图、电子邮件模板以及配置文件更新。

运行迁移

安装后，运行数据库迁移以创建表结构：

mix ecto.migrate

配置路由

在 lib/my_project_web/router.ex 中集成 Coherence 的路由和管道：

pipeline :browser do
  plug :accepts, ["html"]
  plug :fetch_session
  plug :fetch_flash
  plug :protect_from_forgery
  plug :put_secure_browser_headers
  plug Coherence.Authentication.Session
end

scope "/", MyProjectWeb do
  pipe_through :browser
  coherence_routes()
end

应用案例和最佳实践

在构建需要用户认证的应用时，Coherence提供了一个强大的基础。最佳实践中，首先明确您的认证需求，然后仅启用相关模块。利用 Coherence 提供的管道来区分公共访问与受保护资源，确保敏感操作只对已认证的用户开放。对于复杂场景，如细粒度权限控制，考虑结合其他授权库或自定义插件增强安全性。

典型生态项目

虽然 Coherence 自身并未提及特定的“典型生态项目”，但它的设计使得非常适合于任何需要用户管理与认证的 Phoenix 应用程序，如社交网络、在线商城、SAAS平台等。在这些项目中，Coherence通常与其他Elixir生态系统内的技术（比如Absinthe用于GraphQL API、Phoenix Channels用于实时交互）配合使用，共同构建健壮的Web服务。

---

本指南提供了快速入门Coherence的基础步骤，更多高级配置和定制化需求请参考项目官方文档和Wiki页面，以深入了解其丰富的特性和用法。

coherence Coherence is a full featured, configurable authentication system for Phoenix 项目地址: https://gitcode.com/gh_mirrors/co/coherence