采用OAuth 2提供CARSI身份认证功能,CARSI IdP通过OAuth 2接口与学校身份认证系统对接。IdP自动安装脚本已经完成基本配置,与学校部署情况相关、需要修改的部分如下。
1.修改OAuth 2对接参数注意:
下面各配置参数中shibcarsi.serverName,请根据学校IdP域名进行配置。shibcarsi.oauth.oauth2UrlPrefix、shibcarsi.oauth.oauth2clientid、shibcarsi.oauth.oauth2clientsecret、shibcarsi.oauth.oauth2LoginUrl、shibcarsi.oauth.oauth2TokenUrl、shibcarsi.oauth.oauth2ResourceUrl 这些参数由Oauth2服务器管理员提供,请向其咨询。下面shibcarsi.oauth.uidKey = uid 配置项中,请使用oauth2服务器中表示为用户名的那个字段代替uid,具体名称请咨询学校Oauth2认证系统管理员。如果学校的Oauth返回的Token不在第一层, 则需要增加参数 shibcarsi.oauth.tokenKey = data/access_token,但具体参数的值需要根据学校的Oauth数据进行配置。[carsi@www ~]$ sudo vi /opt/shibboleth-idp/conf/authn/authn.properties#修改第102行配置,修改external.jsp为/Authn/Externalidp.authn.External.externalAuthnPath = contextRelative:/Authn/External#新增以下内容:idp.authn.flows = External#设置IdP的域名,请使用学校IdP域名替代xxx.xxx.xxx.xxxshibcarsi.serverName = https://xxx.xxx.xxx.xxx#OAuth2服务器域名、clientid、secret shibcarsi.oauth.oauth2UrlPrefix = http://xxx.xxx.xxx.xxx shibcarsi.oauth.oauth2clientid = xxxxxxx shibcarsi.oauth.oauth2clientsecret = xxxxxxx#OAuth2认证页面以及需要传递的参数shibcarsi.oauth.oauth2LoginUrl = ${shibcarsi.oauth.oauth2UrlPrefix}/authorize.php?response_type=code&client_id=${shibcarsi.oauth.oauth2clientid}&state=xyz# OAuth2用code获取token的URL shibcarsi.oauth.oauth2TokenUrl = ${shibcarsi.oauth.oauth2UrlPrefix}/token.php# OAuth2用token获取资源的URL shibcarsi.oauth.oauth2ResourceUrl = ${shibcarsi.oauth.oauth2UrlPrefix}/resource.php# oauth 释放属性中,作为用户名输入的那个字段。这个字段必须存在,不然会报错,具体名称请咨询学校Oauth2认证系统管理员 shibcarsi.oauth.uidKey = uid2.配置属性定义eduPersonScopedAffiliation属性,取值为用户在学校的身份,其中的“userType”为Oauth2中确定用户身份的属性名称,请替换成实际使用的属性名。关于身份属性取值,需要将Oauth2用户身份的取值,对应到CARSI联盟标准取值,包括:faculty(教师),student(学生),staff(教工),employee(雇员),member(各类人员,包括faculty、student、staff、employee),alum(校友),affiliate(附属人员或临聘,常用),other(CARSI补充,不建议优先使用)。下文样例,将所有的本地用户区分为“staff”、“student”、“member”三种身份。学校可根据实际部署情况选取其中的一部分值。不同SP对用户身份的要求不同,建议配置时尽可能细化用户身份分类,避免后期修改配置。
注:需要修改下述principalAttributeName="usertype"属性定义,principalAttributeName的取值应为Oauth2服务器用于定义用户身份的字段,下面的配置文件以usertype为例,请根据Oauth2服务器实际配置进行修改。 除了身份属性定义外,其他部分不需要修改。如果用户身份属性不在返回的json第一层,则需要根据返回属性的具体情况进行配置。
[carsi@www ~]$ sudo vi /opt/shibboleth-idp/conf/attribute-resolver.xml[carsi@www ~]$ sudo systemctl restart jetty3. 某学校属性配置文件样本在下面的属性配置文件中,在下面的属性配置文件中,principalAttributeName="userType",其中userType是IdP从认证源服务器拿到的用户属性字段名称,该字段用于区别用户身份,请咨询认证源服务器管理员并获得该字段名称。
[carsi@www ~]$ sudo cat attribute-resolver.xmlurn:mace:dir:entitlement:common-lib-termsMyDataSource4. 配置属性释放IdP安装脚本已经完成属性释放配置,可不修改。