Outline使用Authelia实现本地认证

最新推荐文章于 2024-03-19 09:44:25 发布
最新推荐文章于 2024-03-19 09:44:25 发布
阅读量4.6k 收藏 2
点赞数 1
文章标签： 群晖 docker sso oidc
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/wbsu2004/article/details/123416421
版权

在 『 基于Outline构建团队的知识库（上篇） 』 一文中老苏介绍过 Outline 需要借助于第三方认证，同时老苏也关注到 Authelia 支持 OIDC 认证，虽然 Authelia 官方强调还是 β版 ，但老苏还是觉得应该试试，毕竟如果成功了就可以让 Outline 实现真正意义上的本地化部署了

【重要提示】：

老苏只是记录安装方法和过程，不对你的数据负任何责任😳

  1. 如果你是第一次安装，请先看看 Outline 和 Authelia 的安装，会有助于理解本文，因为有👇这些铺垫，所以只对新增的内容做了简要的描述

  2. authelia 不支持在非标准端口上运行，表现为存在截掉端口的现象，按作者的说法，可能要等到 v4.34 才会修复，所以很多步骤需要自己手动添加端口，如果你是备案了的域名，就不存在这样的烦恼

  3. 登录成功再 logout 之后，只会显示上次登录成功的方式，所以如果你之前实践过 slack 登录，就算你按照本文操作成功，登录界面也是看不到的，老苏解决的办法简单粗暴，直接删空 data 目录，如果你已经有笔记数据了请慎重！慎重！慎重！一定要三思而后行

什么是 OpenID Connect（OIDC）？

OpenID Connect 1.0 是 OAuth 2.0 协议之上的简单身份层。它允许客户端根据授权服务器执行的身份验证验证最终用户的身份，并以可互操作和类似 REST 的方式获取有关最终用户的基本配置文件信息。

OpenID Connect 允许所有类型的客户端（包括基于 Web、移动和 JavaScript 的客户端）请求和接收有关经过身份验证的会话和最终用户的信息。该规范套件是可扩展的，允许参与者在对他们有意义的情况下使用可选功能，例如身份数据加密、OpenID 提供者发现和会话管理。

老苏的把本文用到的文件都放在了这里👉： https://github.com/wbsu2003/synology/tree/main/outline(OIDC)

设置 Authelia

Authelia 官方在 https://www.authelia.com/docs/configuration/identity-providers/oidc.html 为 OIDC 身份提供者提供了一个示例配置，同时也详细解释了每个字段

在原来的 Authelia 的配置文件 configuration.yml 尾部增加了 identity_providers，这里只对需要修改处做简单的说明

  • hmac_secret
    hmac_secret: this_is_a_secret_abc123abc123abc

hmac_secret 是用于签署 OpenID Connect JWT 的 HMAC 密钥。为了满足所需的格式，提供的字符串被散列为 SHA256 字节字符串。您必须自己生成此选项。

官方推荐用👇下面的代码来生成

LENGTH=64
tr -cd '[:alnum:]' < /dev/urandom | fold -w "${LENGTH}" | head -n 1 | tr -d '\n' ; echo

也可以用之前老苏用过的 openssl rand -hex 32

如果命令行都不想用，就用 bitwarden 的密码生成器吧

  • issuer_private_key

采用 DER base64 编码的 PEM 格式的私钥，用于加密 OpenID Connect JWT

第一步、需要在 authelia 中建一个子目录 keys

第二步、停止 authelia 容器，右键 编辑 --> 存储空间 --> 添加文件夹

第三步、启动 authelia 容器，并进入终端机

执行下面👇的命令

# 生成秘钥
authelia rsa generate --dir /keys

如果你更喜欢命令行，也可以直接在 SSH 客户端中运行

# 进入容器
docker exec --user root -it <容器名称> /bin/sh

# 生成秘钥
authelia rsa generate --dir /keys

在 File Station 中能看到生成的公钥和私钥文件

将 key.pem 重命名为 key.pem.txt 后，可以直接打开复制

复制完成后，记得把文件名改回去

所以最后应该是这个样子的

    issuer_private_key: |
      -----BEGIN RSA PRIVATE KEY-----
      MIIEpAIBAAKC...
      -----END RSA PRIVATE KEY-----
  • clients
    clients:
      - id: outline
        description: Outline Wiki
		secret: 856d53b8eb53c6d4e30194a2

此客户端的客户端 ID。它必须与使用此客户端的应用程序中配置的客户端 ID 完全匹配。

因为是配置给 outline 用的，所以 id 用了 outline，后面在环境变量文件中还会用到

  • redirect_uris
        redirect_uris:
          - https://ot.laosu.ml:444/auth/oidc.callback

此客户端将重定向到的有效回调 URI 列表。所有其他回调将被视为不安全。URI 区分大小写，outline 的 OIDC 回调地址是 https://<URL>/auth/oidc.callback

把 <URL> 替换为域名 https://ot.laosu.ml:444/auth/oidc.callback

如果没备案，有端口也要带上

以上工作完成，记得重启容器

设置 Outline

修改 docker.env.txt

  1. 通用参数部分

老苏增加了几行，用于 OIDC 的设置

YOUR_OIDC_CLIENT_ID=outline
YOUR_OIDC_CLIENT_SECRET=856d53b8eb53c6d4e30194a2
AUTHELIA_URL=https://auth.laosu.ml:444

这里的 YOUR_OIDC_CLIENT_ID 对应前面设置的 configuration.yml中 clients 的 id，YOUR_OIDC_CLIENT_SECRET 对应 clients 的 secret

AUTHELIA_URL 是指 Authelia 的域名

  1. AUTHENTICATION 部分

docker.env.txt 中已经预留了 OIDC 的认证，但相关内容原来后面的空的，需要补填

# To configure generic OIDC auth, you'll need some kind of identity provider.
# See documentation for whichever IdP you use to acquire the following info:
# Redirect URI is https://<URL>/auth/oidc.callback
OIDC_CLIENT_ID=${YOUR_OIDC_CLIENT_ID}
OIDC_CLIENT_SECRET=${YOUR_OIDC_CLIENT_SECRET}
OIDC_AUTH_URI=${AUTHELIA_URL}/api/oidc/authorize
OIDC_TOKEN_URI=${AUTHELIA_URL}/api/oidc/token
OIDC_USERINFO_URI=${AUTHELIA_URL}/api/oidc/userinfo

# Specify which claims to derive user information from
# Supports any valid JSON path with the JWT payload
OIDC_USERNAME_CLAIM=preferred_username

# Display name for OIDC authentication
OIDC_DISPLAY_NAME=Authelia

# Space separated auth scopes.
OIDC_SCOPES="openid profile email"

OIDC_DISPLAY_NAME 是显示的名称

修改 docker-compose.yml

docker-compose.yml 在 outline 的环境变量部分增加下面的内容

      - OIDC_CLIENT_ID=${OIDC_CLIENT_ID}
      - OIDC_CLIENT_SECRET=${OIDC_CLIENT_SECRET}
      - OIDC_AUTH_URI=${OIDC_AUTH_URI}
      - OIDC_TOKEN_URI=${OIDC_TOKEN_URI}
      - OIDC_USERINFO_URI=${OIDC_USERINFO_URI}
      - OIDC_USERNAME_CLAIM=${OIDC_USERNAME_CLAIM}
      - OIDC_DISPLAY_NAME=${OIDC_DISPLAY_NAME}
      - OIDC_SCOPES=${OIDC_SCOPES}

同时注释掉了原来的 slack，不注释也可以，但是你用 OIDC 登陆成功一次后，slack 也就不再显示了

为了演示，老苏把三种认证方式都打开了

运行

在 SSH 客户端执行下面的命令

如果你是第一次安装，不需要执行 一键删除， 一键删除 并不会删除数据，删除 outline 中的子文件夹才会

# 进入 outline 目录
cd /volume2/docker/outline

# 一键删除
docker-compose --env-file docker.env.txt down

# 一键运行
docker-compose --env-file docker.env.txt up -d

在浏览器中打开 https://ot.laosu.ml:444

选择 使用 Authelia 继续，浏览器中地址会变成 https://auth.laosu.ml/，并显示 无法访问此网站

如果你是没备案的域名，需手动添加端口，老苏的是 444，加好后直接回车

因为前面设置了 two_factor，还需要输入 OTP 密码，如果是是 one_factor 就直接跳到下个界面了

认证完成后地址栏会变成 https://auth.laosu.ml/consent，需再次动添加端口 444，然后回车

点蓝色的 ACCEPT 按钮后，会再次显示 无法访问此网站，需第三次添加端口，然后回车，就能看到主界面了

只要你不 退出登录，下次打开是可以直接进入到主界面的，但只要你退出了，其他的登录方式就消失了

参考文档

OpenID Connect | OpenID
地址：https://openid.net/connect/

OpenID Connect - Authelia
地址：https://www.authelia.com/docs/configuration/identity-providers/oidc.html

Guide for installing Outline with Authelia as an OpenID provider | by Rigaut-Luczak Lola | Medium
地址：https://medium.com/@Lola_Dam/guide-for-installing-outline-with-authelia-as-an-openid-provider-129a141f6090

Deploying Outline Wiki :: Guru Computing Blog
地址：https://blog.gurucomputing.com.au/doing-more-with-docker/deploying-outline-wiki/

杨浦老苏
关注
authelia：适用于Web应用程序的Single Sign-On Multi-Factor门户
02-02
Authelia是一种开源身份验证和授权服务器，可通过Web门户为您的应用程序提供2要素身份验证和单点登录（SSO）。 它充当反向代理（如 ， 或的伴侣，以使他们知道查询是否应该通过。 未经身份验证的用户将重定向到Authelia登录门户。 可从获得文档。 下图显示了该体系结构。 Authelia可以作为独立服务从 ， ，也可以使用或来利用入口控制器和入口配置进行安装。 非常感谢您协助发布。 这是Authelia的门户网站的样子 功能概要 以下是主要可用功能的列表： 第二种因素： 带有 。 使用。 带有。 使用电子邮件确认通过身份验证重置密码。 提供仅单因素身份验证方法。 尝试过多身份验证后的访问限制。 每个子域，用户，资源和网络的细粒度访问控制。 支持受单一因素保护的端点的基本身份验证。 使用远程数据库具有很高的可用性，Redis可作为高可用性KV存储使用。 开箱即用与Kubernetes 控制器兼容。 有关功能的更多详细信息，请遵循。 如果您想进一步了解路线图，请遵循。 代理支持 Authelia与 ， 或结合使用。 它可以使用Docker部署在裸
authelia：在unRAID操作系统中部署Authelia的说明和配置文件
02-05
authelia：在unRAID操作系统中部署Authelia的说明和配置文件
探秘Authelia：一站式身份验证和访问控制解决方案
最新发布
gitblog_00064的博客
03-19 790
探秘Authelia：一站式身份验证和访问控制解决方案 autheliaThe Single Sign-On Multi-Factor portal for web apps项目地址:https://gitcode.com/gh_mirrors/au/authelia 是一个开源的身份验证和访问控制解决方案，它为你的应用程序提供了强大的安全层。通过集成多因素认证（MFA）和其他高级安全特性，Au...
开源SSO Authelia部署（Docker+Ubuntu）
Purpose_7的博客
11-29 4709
开源SSO Authelia部署（Docker+Ubuntu）
Win10部署Authelia（OAuth2授权框架）
Konan96的博客
10-10 2667
一、安装docker 二、下载authelia代码 # 下载代码并切换到本地运行例子 git clone https://github.com/authelia/authelia.git cd authelia/examples/compose/local 三、配置相关参数 打开configuration.yml查看配置 具体参数详解可查看： https://www.authelia.com/docs/configuration/ 1、访问控制 access_control: default_po
单点登录服务Authelia（上篇）
wbsu2004的博客
03-07 1万+
Authelia 是一个开源的身份认证和授权服务器。
使用CSS实现outline切换的动画效果
09-25
标题中的“使用CSS实现outline切换的动画效果”指的是在网页设计中，利用CSS（层叠样式表）技术来创建一种动态的聚焦轮廓效果。当用户通过键盘的Tab键在页面上的表单元素之间切换焦点时，通常会有默认的outline显示...
PC端windows使用Outline，Outline-Client
01-30
Outline-Client上网用,PC端windows使用
cadence allegro 17.2 design outline的使用问题
02-14
在Cadence Allegro 17.2版本中，设计者们遇到了一个显著的变化，那就是设计大纲（Design Outline）的使用方式。以往版本中，设计师通常使用Outline层来定义电路板的外观，但在17.2版中，Cadence推荐使用Design ...
Unity Shader实现描边OutLine效果
08-25
Unity Shader实现描边OutLine效果 本文主要介绍了 Unity Shader 实现描边 OutLine 效果的方法，通过详细的示例代码和解释，帮助读者快速掌握该技术。 描边 OutLine 效果的实现 描边 OutLine 效果是通过 Unity ...
autheliar:Authelia API的R接口
03-06
权威的 Authelia API的R接口
Outline-Client.rar
08-08
Outline-Client.ext是一款比较好用的网络代理客户端软件，配套的有服务器软件，建议配套一起使用
oidc-tester-app:实施OpenID Connect的应用程序，用于与Authelia进行测试
04-12
oidc-tester-app oidc-tester-app是用于测试Authelia提供的OIDC API的OIDC客户端 执照 该软件已获得 ）许可。
authelia-docker-swarm:在docker swarm上部署aulitelia lite的示例
04-10
在docker swarm上部署aulitelia lite的示例 $ docker swarm init && docker network create --driver=overlay traefik-public $ git clone https://github.com/wuhanstudio/authelia-docker-swarm && cd authelia-docker-swarm # Replace wuhanstudio.cc with your domain $ find . -type f -name "*.yml" -exec sed -i'' -e 's/example.com/wuhanstudio.cc/g' {} + # Replace wuhanstudio@qq.com with your email $ find . -type f -name
oidc-debugger:OAuth 2.0和OpenID Connect调试工具
05-11
OAuth 2.0和OpenID Connect调试器 :globe_showing_Americas: 住在这里： : 或 这是什么？ 阅读博客文章： 要使OAuth或OpenID Connect流正常工作可能会很棘手。 您需要一堆正确的参数，而且捕获或解析错误并不总是那么容易。 我写了这个小的网络工具来简化过程。 如何使用调试器 您需要做的只是暂时将OAuth客户端重定向URI设置为https://oidcdebugger.com/debug （或https://oauthdebugger.com/debug ）： 然后，使用调试器向授权服务器生成请求，然后将其触发： 调试器将捕获回调并帮助您了解发生了什么（无论成功还是失败）： 贡献 欢迎发布问题和PR！ 该项目使用ASP.NET Core和Vue.js构建。 要在本地构建和运行， git clone https://github.com/nbarbettini/
单点登录服务Authelia（下篇）
wbsu2004的博客
03-09 5407
Authelia 是一个开源的身份认证和授权服务器。
【 云原生 kubernetes 】- 单点登录Authelia + OpenLdap
ycloud
06-25 2201
Authelia是一个开源的单点登录身份验证系统，可以用于保护Web应用程序、API和其他服务
outline使用
热门推荐
随手写下笔记和感悟
06-17 6万+
outline
Outline Effect使用详细步骤
05-17
Outline Effect是一种在Unity中创建边框效果的技术。以下是使用Outline Effect的详细步骤： 1. 下载Outline Effect插件并导入到Unity项目中。 2. 在需要应用Outline Effect的游戏对象上添加Outline组件。 3. 在Outline组件中设置轮廓线的颜色、宽度和填充颜色等属性。 4. 在Outline组件下方添加一个子对象，并将该子对象的渲染模式设置为“Transparent”。 5. 在该子对象上添加一个Mesh Renderer组件，并将其使用的材质设置为应用了Outline Effect的材质。 6. 在该子对象的材质中启用“Use Pass”选项，并选择“Outline”作为通道。 7. 在游戏运行时，Outline Effect将会应用到指定的游戏对象上，创建出边框效果。 需要注意的是，Outline Effect使用了屏幕空间渲染技术，因此在场景中应用该效果时，需要将摄像机的渲染模式设置为“Screen Space - Overlay”。此外，Outline Effect也可能会对游戏性能造成一定的影响，需要在使用时谨慎评估。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

杨浦老苏

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值