【亲测免费】 使用指南：Jellyfin SSO插件集成单点登录功能

项目介绍

Jellyfin SSO插件 是一个专为Jellyfin媒体服务器设计的扩展，它使用户能够通过诸如Google、Microsoft等SSO（单点登录）服务进行一键登录。该插件简化了用户的登录过程，支持自定义提供商，增强用户体验，同时也适用于那些希望在企业环境下实施统一身份验证的场景。

项目快速启动

安装插件

1. 添加仓库: 首先，在你的Jellyfin安装中，你需要添加此插件的存储库URL到Jellyfin的插件源列表中。打开设置，找到插件管理的“从互联网安装”部分，然后添加以下仓库地址：

   https://raw.githubusercontent.com/9p4/jellyfin-plugin-sso/manifest-release/manifest.json
   

2. 安装插件: 在Jellyfin的插件目录里查找新添加的“SSO登录”插件并安装它。

配置示例

由于配置需通过API完成，这里提供一个简单的OpenID配置示例（使用curl）：

curl -v -X POST -H "Content-Type:application/json" -d '[
    "oidEndpoint": "https://youropenidprovider.com/auth",
    "oidClientId": "jellyfin-openid-client",
    "oidSecret": "your_secret_here",
    "enabled": true,
    "enableAuthorization": true
]':
    "https://yourjellyfinserver.com/sso/OID/Add/YOUR_PROVIDER_NAME?api_key=YOUR_API_KEY"

确保替换YOUROPENIDPROVIDER.COM, jellyfin-openid-client, your_secret_here, YOUR_JELLYFINSERVER.COM, YOUR_PROVIDER_NAME, 和 YOUR_API_KEY 为实际值。

应用案例和最佳实践

• 登录页面定制: 利用Jellyfin的自定义HTML功能，可以添加一个直接链接到SSO登录的过程。在“常规”->“品牌”设置下，加入如下的HTML代码创建一个登录按钮：

  <form action="https://yourjellyfin.com/sso/OID/start/YOUR_PROVIDER">
      <button class="raised block emby-button button-submit">使用SSO登录</button>
  </form>
  

  同时，在“自定义CSS代码”中添加样式以调整外观。

• 用户权限管理: 结合Jellyfin的RBAC(角色基础访问控制)，可以通过SSO提供商分配的角色来映射用户权限，实现细粒度的内容访问控制。

典型生态项目

虽然本项目专注于Jellyfin的SSO集成，但其在媒体管理和家庭娱乐生态系统中的位置重要，它可以与各种第三方媒体桥接器（如Plex Media Server迁移工具）、自动化脚本（如利用Gulp或Git hooks自动管理媒体库）以及云同步服务（例如Nextcloud集成）配合使用，共同构建一个更加智能化的家庭媒体中心环境。

通过这个插件，不仅提升了用户登录体验，也为Jellyfin社区引入了现代认证机制，使其在多种场景下更适合作为企业级媒体解决方案的一部分。