Cisco Cisco Identity Services Engine Software Prospecto
6-4
思科身份服务引擎 API 参考指南,版本 1.4
OL-26134-01
第 6 章 访客 REST API
访客 REST API 请求
请求内容
以下 XML 内容显示访客用户帐户的结构,包括自定义字段:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ns3:guestuser name="guestUser" id="123456789" description="ERS Example user "
xmlns:ns2="ers.ise.cisco.com" xmlns:ns3="identity.ers.ise.cisco.com">
<customFields>
<entry>
<key>some key</key>
<value>some value</value>
</entry>
<entry>
<key>another key</key>
<value>and its value</value>
</entry>
</customFields>
<guestInfo>
<emailAddress>email@some.uri.com</emailAddress>
<enabled>true</enabled>
<password>asdlkj324ew</password>
<phoneNumber>3211239034</phoneNumber>
<smsServiceProvider>GLobal Default</smsServiceProvider>
<userName>DS3ewdsa34wWE</userName>
</guestInfo>
<guestType>Contractor</guestType>
<portalId>23423432523</portalId>
<sponsorUserName>Mr Spons</sponsorUserName>
</ns3:guestuser>
以下请求示例显示有关使用 POST(创建)操作创建访客用户帐户所需的 XML 内容。
注意
创建访客用户帐户所需的字段无需与发起人门户中显示的必填字段对应。但是,如果发起人门户
不提供创建访客用户帐户所需的信息,访客 REST API 会引发异常。
不提供创建访客用户帐户所需的信息,访客 REST API 会引发异常。
POST 请求示例
POST https://<ISE-Admin-Node>:9060/ers/config/guestuser/
Accept: application/vnd.com.cisco.ise.identity.guestuser.2.0+xml
Content-Type: application/vnd.com.cisco.ise.identity.guestuser.2.0+xml
Authorization: Basic xxxxxxxxxxxxxxxxx
<?xml version="1.0" encoding="UTF-8"?>
<ns2:guestuser xmlns:ns2="identity.ers.ise.cisco.com">
<guestAccessInfo>
<fromDate>08/06/2014 23:22</fromDate>
<toDate>08/07/2014 23:22</toDate>
<validDays>1</validDays>
</guestAccessInfo>
<guestInfo>
<company>New Company</company>
<emailAddress>john@example.com</emailAddress>
<firstName>John</firstName>
<lastName>Doe</lastName>
<notificationLanguage>English</notificationLanguage>
<password>12345</password>
<phoneNumber>9999998877</phoneNumber>
<smsServiceProvider>Global Default</smsServiceProvider>
<userName>autoguestuser1</userName>