上一页 | 下一页 |
启用安全性的模型中的用户凭据
如果通过Pro Cloud Server连接的模型启用了用户安全性,则您必须在检索,更新,创建或删除资源/资源功能之前验证用户凭据。验证用户凭证后,您将获得一个用户身份验证令牌,您必须通过OSLC GET和POST请求传入该用户身份验证令牌。除非您传入用户身份验证令牌,否则Pro Cloud Server将不会处理Security Enabled模型上的OSLC请求。
获取用户身份验证令牌:
- 将用户的Enterprise Architect模型安全凭证(用户ID和密码)发布到特定URL; 这些凭据与您在启用安全性的模型中的“登录EA存储库”对话框中输入的凭据相同
- 成功验证后,返回的XML将包含XML元素的用户身份验证令牌(以及其他信息):useridentifier'
在启用安全性的模型中验证用户凭据
步骤 |
描述 |
---|---|
1 |
通过将用户的Enterprise Architect模型安全凭证发布到以下内容来验证用户: URL:<protocol>:// <server> / <model_name> / oslc / am / login / POST Body:uid = <USER ID>; pwd = <PASSWORD> |
2 |
如果验证成功,响应通常为:
<?xml version =“1.0”encoding =“UTF-8”?> <rdf:RDF xmlns:rdf =“http://www.w3.org/1999/02/22-rdf-syntax-ns#” 的xmlns:SS = “http://www.sparxsystems.com.au/oslc_am#” 的xmlns:FOAF = “http://xmlns.com/foaf/0.1/”> <SS:login> <! - 布尔值,指定模型是否允许资源创建/更新 - > <SS:readonlymodel> VALUE </ SS:readonlymodel> <! - 布尔值,指定您是否拥有有效的Pro Cloud Server许可证 - > <SS:validlicense> VALUE </ SS:validlicense> <! - 在启用安全性的模型中指定用户的全名 - > <SS:userfullname> <FOAF:Person> <foaf:name>网络用户</ foaf:name> </ FOAF:Person> </ SS:userfullname> <! - 指定用户认证令牌 - > <ss:useridentifier> USER AUTHENTICATION TOKEN </ ss:useridentifier> <! - 布尔值,指定您是否有权创建/更新资源 - > <SS:elementpermission> VALUE </ SS:elementpermission> <! - 布尔值,指定您是否有权更新图表 - > <SS:diagrampermission> VALUE </ SS:diagrampermission> <! - 布尔值,指定您是否有权创建/更新资源测试 - > <SS:testpermission> VALUE </ SS:testpermission> <! - 布尔值,指定您是否有权创建/更新资源分配 - > <SS:resourceallocationpermission> VALUE </ SS:resourceallocationpermission> <! - 布尔值,指定您是否有权创建/更新资源维护项目 - > <SS:maintenanceitempermission> VALUE </ SS:maintenanceitempermission> <! - 布尔值,指定您是否有权创建/更新资源项目管理项 - > <SS:projectmanagementitempermission> VALUE </ SS:projectmanagementitempermission> </ SS:登录> </ RDF:RDF> |
使用OSLC请求传递用户身份验证令牌
成功验证用户凭据后,您将在每个OSLC请求中传入用户身份验证令牌; 也就是说,传入用户身份验证令牌:
- 使用GET请求检索资源或资源要素XML作为查询字符串参数'useridentifier'的值时
- 使用POST RDF / XML创建/更新资源或资源功能时,作为XML元素的值:useridentifier'
使用GET请求传递用户身份验证令牌
对于GET请求,将用户身份验证令牌作为查询字符串参数'useridentifier'的值传递:
- <protocol>:// <server> / <model_name> / oslc / am / OSLC REQUEST /?useridentifier = <USER AUTHENTICATION TOKEN>
例子
步骤 |
示例输入 |
---|---|
1 |
检索Enterprise Architect包资源的属性:
HTTP://localhost:480 / firebird_model / OSLC / AM /resource/ PK_ {5147E138-1F14-4738-B721-5FCC0F8821A8} / UserIdentifier的= {72825AF9-E116-48f1-9DF8-77815E66B1A7}? |
2 |
检索所有资源:
HTTP://localhost:480 / firebird_model / OSLC / AM / QC / UserIdentifier的= {72825AF9-E116-48f1-9DF8-77815E66B1A7}&oslc.where = DCTERMS:title= “Class1” |
使用OSLC POST请求传入用户身份验证令牌
对于OSLC POST请求,您需要将用户身份验证令牌作为POST请求附带的RDF / XML的一部分传递。
例子
步骤 |
输入 |
---|---|
1 |
在启用安全性的模型中:
注释,复杂性和版本已设置。
<?xml version =“1.0”encoding =“UTF-8”?> <rdf:RDF xmlns:oslc_am =“http://open-services.net/ns/am#” 的xmlns:RDF = “http://www.w3.org/1999/02/22-rdf-syntax-ns#” xmlns:dcterms =“http://purl.org/dc/terms / ” 的xmlns:FOAF = “http://xmlns.com/foaf/0.1/” 的xmlns:SS = “http://www.sparxsystems.com.au/oslc_am#”> <oslc_am:Resource> <! - 必需属性 - > <DCTERMS:title>Class1 </ DCTERMS:title> <DCTERMS:type>Class</ DCTERMS:type> <SS:parentresourceidentifier> PK_ {259A54C2-6A89-46d7-AB7E-F192668010CA} </ SS:parentresourceidentifier> <dcterms:description>Created via OSLC</ dcterms:description> <SS:complexity>Easy</ SS:complexity> <SS:version> 1.0 </ SS:version> <SS:UserIdentifier> {72825AF9-E116-48f1-9DF8-77815E66B1A7} </ SS:UserIdentifier> </ oslc_am:Resource> </ RDF:RDF> |
2 |
在启用安全性的模型中:
<?xml version =“1.0”encoding =“UTF-8”?> <rdf:RDF xmlns:oslc_am =“http://open-services.net/ns/am#” xmlns:RDF = “http://www.w3.org/1999/02/22-rdf-syntax-ns#” xmlns:DCTERMS = “http://purl.org/dc/terms/” xmlns:FOAF = “http://xmlns.com/foaf/0.1/” xmlns:SS = “http://www.sparxsystems.com.au/oslc_am#”> <oslc_am:Resource> <! - 必需属性 - > <DCTERMS:identifier> el_ {567854C2-6A89-46d7-AB7E-F192668010CA} </ DCTERMS:identifier> <DCTERMS:title> Actor1_New </ DCTERMS:identifier> <SS:UserIdentifier的> {72825AF9-E116-48f1-9DF8-77815E66B1A7} </ SS:UserIdentifier的> </ oslc_am:Resource> </ RDF:RDF> |
笔记
- 此工具可通过Enterprise Architect版本13.5或更高版本下的Enterprise Architect Pro云服务器版本获得:Small Business Edition,Team Server Edition和Enterprise Server Edition
- Pro Cloud服务器不会处理OSLC请求,除非在启用安全性的模型上传入请求时传入用户身份验证令牌
- 30分钟不活动将使您退出Security Enabled模型; 您必须通过将用户凭据发布到凭证验证URL再次登录
学到更多