MyOIDC | MONKEYK.博客

MyOIDC v1.1.2 发布，基于OIDC协议的参考实现

By andaily in access_token, jose4j, MyOIDC, Oauth, OpenId-Connect, Spring-Boot, spring-security, 原创 2022-01-27 0 Comment 429 views

MyOIDC — 基于OIDC协议的参考实现,根据各类库提供实现参考。正式版本v1.1.2发布，此版本主要是安全升级，更新内容：

1.为了处理CVE安全漏洞，对以下依赖库进行了升级：

spring-boot升级到v2.5.9；
spring-security-oauth2升级到v2.3.8.RELEASE
guava升级到v31.0-jre

2.增加了banner.txt，更新README.md让使用者更易上手

3.修复已知的各类bug

v1.1.2 tag：https://gitee.com/mkk/MyOIDC/tree/v1.1.2

OAuth2中token升级使用JWT的实现参考

By andaily in access_token, MyOIDC, Oauth, OpenId-Connect, spring-security, 原创 2020-11-15 0 Comment 2,284 views

OAuth2中默认使用 Bearer Tokens (一般用UUID值)作为token的数据格式，但也支持升级使用JSON Web Token(JWT)来作为token的数据格式。

下面以 spring-oauth-server 升级使用JWT来说明

重点在于提供一个 JwtTokenStore的配置类，详细可参见 MyOIDC 工程中的配置：https://gitee.com/mkk/MyOIDC/blob/master/myoidc-server/src/main/java/myoidc/server/config/OAuth2ServerConfiguration.java

需要注意的是底层使用的算法，可以是RSA也可以对称加密的HMAC等，具体可查看 JwtAccessTokenConverter.java 类。

对应的工程中需要增加 spring-security-jwt 库的依赖（如果是Maven工程）。

OIDC中JWK,JWKS的介绍与使用

By andaily in jose4j, MyOIDC, OIDC, OpenId-Connect, 原创, 稀缺, 面向期望 2020-09-20 0 Comment 13,768 views

JWKS全称为 JSON Web Key Set，是指多个JWK组合在一起的一种格式(详见 https://tools.ietf.org/html/draft-ietf-jose-json-web-key-41#section-5 )；

JWK全称是JSON Web Key，其标准协议链接：https://tools.ietf.org/html/draft-ietf-jose-json-web-key-41

JWK在OIDC中的主要作用是为JWT(id_token)提供加密密钥，用于加密/解密或签名/验签，是JSON格式的数据。

综上所说，掌握了如何生成JWK，再按照JWKS协议的要求组合起来即可。根据使用不同的加密算法，各种算法的JWK展示内容会有些区别，一个使用RSA算法的JWK格式的数据如下，使用jose4j生成：

{
  "kty": "RSA",
  "kid": "myoidc-keyid",
  "use": "sig",
  "alg": "RS256",
  "n": "xMNL1jDatbHWGDH_H9GZbb2R4Ck2ga-lfE6wJnno_MfqJibSqkiLTZ7P06woJFxzB0WDu2PBe-ptRNoJhEnkzL8c1mgbGOdPVCsaaDm-POGZ3gnWGcyzyuJ9s9km41Rlan3TuuC3HIniY4bmyQAZ-SLwrFk7Bfa91ui4F9S5RvM",
  "e": "AQAB",
  "d": "q73XDM65p8vgll_VUn2NUPcdQ65VUB7y76xzHjJchX8tRj2utUj6pjaPKi_jHdG_6UHouIBa2oEE_QrfMaOZ2wA6LgYPXT_a296LKoOtKKRUlgob_leHxn0FJxLOXtEHgMqDgtMQ1-eFipsFgriip94dmcLEWW3YVK_y5JwJrnE",
  "p": "7OqN19bEbMb9cr9zA98QQq9LOgvQfq5-nOvzwMsubqMosHxViRnivFz2-3LpusK7u2XEG5EljqUxZrf4lgeVmw",
  "q": "1Jy9ksoLuQ5tuc4docgLaXQWqf3iaTm3iC07AA4v9jHzvnkewWFS_PUPPcra4475Dew-y7oIENaRBMijrrWViQ",
  "dp": "HBEdhLh4xLo-RF3R7l96uauyqcnEhX1-mnCJjAmGEq1ZoK7aI0fhyJbq25cdgXaYbvb7aJilbmS7mYOp-3wiiQ",
  "dq": "NRMLn-EgHAomCgQSEZjGgISiQ71FD8-AqVXhLJpeDq9ZkWra6ptJBCyIqXxCOBwwv_EBnAnMiaeGfBM6CRr7QQ",
  "qi": "VCdAeu4h25X_kM69Netc3SKPo5P-1VjeSHz0Ko0QuSMF0INc6H2yi7hZgZuYANVaTF1Ipf6lWfHBLpuRGh3lXw"
}

JWK数据的格式具体可参见 https://tools.ietf.org/html/draft-ietf-jose-json-web-key-41#section-4

主要属性：kty(Key类型)，use(两个可选值：sig or enc)，alg(具体的算法)，kid(Key的唯一标识id)

有了JWK数据，只需要按照JWKS的格式组装成对应的JSON数据即可，以上面的JWK组装的JWKS数据如下：

{
  "keys": [
    {
      "p": "7OqN19bEbMb9cr9zA98QQq9LOgvQfq5-nOvzwMsubqMosHxViRnivFz2-3LpusK7u2XEG5EljqUxZrf4lgeVmw",
      "kty": "RSA",
      "q": "1Jy9ksoLuQ5tuc4docgLaXQWqf3iaTm3iC07AA4v9jHzvnkewWFS_PUPPcra4475Dew-y7oIENaRBMijrrWViQ",
      "d": "q73XDM65p8vgll_VUn2NUPcdQ65VUB7y76xzHjJchX8tRj2utUj6pjaPKi_jHdG_6UHouIBa2oEE_QrfMaOZ2wA6LgYPXT_a296LKoOtKKRUlgob_leHxn0FJxLOXtEHgMqDgtMQ1-eFipsFgriip94dmcLEWW3YVK_y5JwJrnE",
      "e": "AQAB",
      "use": "sig",
      "kid": "myoidc-keyid",
      "qi": "VCdAeu4h25X_kM69Netc3SKPo5P-1VjeSHz0Ko0QuSMF0INc6H2yi7hZgZuYANVaTF1Ipf6lWfHBLpuRGh3lXw",
      "dp": "HBEdhLh4xLo-RF3R7l96uauyqcnEhX1-mnCJjAmGEq1ZoK7aI0fhyJbq25cdgXaYbvb7aJilbmS7mYOp-3wiiQ",
      "alg": "RS256",
      "dq": "NRMLn-EgHAomCgQSEZjGgISiQ71FD8-AqVXhLJpeDq9ZkWra6ptJBCyIqXxCOBwwv_EBnAnMiaeGfBM6CRr7QQ",
      "n": "xMNL1jDatbHWGDH_H9GZbb2R4Ck2ga-lfE6wJnno_MfqJibSqkiLTZ7P06woJFxzB0WDu2PBe-ptRNoJhEnkzL8c1mgbGOdPVCsaaDm-POGZ3gnWGcyzyuJ9s9km41Rlan3TuuC3HIniY4bmyQAZ-SLwrFk7Bfa91ui4F9S5RvM"
    }
  ]
}

以上的JWK,JWKS的示例的完整代码(JAVA实现)可在此查看 https://gitee.com/mkk/MyOIDC/blob/master/myoidc-server/src/test/java/myoidc/server/infrastructure/JWKSTest.java。代码中还包括除RSA外，ECC，OCT的示例实现。

JWK本身未定义一种新的加密算法或变种，只是定义一种JSON格式的数据展示(更符合互联网传输)，其底层实现依旧依赖PKI体系的技术，如x509，公钥/私钥体系。在其协议介绍中能更好地体现出来。

如果是使用非JAVA语言，也可以使用对应的PKI技术生成JWK，如openssl；

一个使用JDK自带的 keytool 工具生成的示例如下：

keytool -genkeypair -alias oidc-demo -validity 180 -keyalg RSA -keypass oidc-demo -keystore oidc-demo.jks -storepass oidc-demo

命令输入后依次填写DN的各类信息，即可生成 oidc-demo.jks文件，密码为 oidc-demo，文件中有私钥公钥等信息。

若需要导出为 x509格式数据，使用keytool命令：

keytool -exportcert -keystore oidc-demo.jks -rfc -file oidc-demo.cer -alias oidc-demo

输入密码后生成的 oidc-demo.cer文件为x509格式。

OIDC中的术语介绍与示例

By andaily in API, MyOIDC, Oauth, oauth2-shiro, OIDC, OpenId-Connect, 原创 2020-09-20 0 Comment 2,561 views

以下对OIDC主要的术语进行说明，并与OAuth2作相关对比。

EU End-User, 指用户(一般指有账号的个体，资源的拥有者)
RP Relying Party, 信任方(一般是一个软件应用), 理解为OAuth2中的客户端(client)即可, 需要在OP中注册
OP OpenID Provider, 能提供对EU进行认证的服务端(可理解为OAuth2中授权服务端),
提供RP的注册(或管理)能力，EU管理，ID Token的签发与管理等。OIDC中的核心组件。
OIDC-Server 就是一个OP的参考实现
ID Token 格式为JSON Web Token(JWT),
包含EU认证授权信息等. 有关JWT请访问 https://jwt.io/除了JWT, 知道以下概念对掌握OIDC会很有帮助
JSON Web Key(JWK),
JSON Web Encryption(JWE),
JSON Web Algorithm(JWA),
JSON Web Signature(JWS)
UserInfo Endpoint EU信息接口(OAuth2保护), 在RP获取到access_token后,可调用此接口获取EU的详细信息.
OIDC要求此接口必须使用https访问(更安全)；一般在OP中提供的Discovery中获取
Claim EU信息的载体, 可在id_token中获取,主要包括认证信息与授权信息，可根据实际扩展
查看完整术语定义请访问 https://openid.net/specs/openid-connect-core-1_0.html#Terminology