透過Insominia的ISE 3.3中的JSON或XML和API呼叫配置內部使用者

下載選項

PDF (1.9 MB)
在多種裝置上使用 Adobe Reader 檢視
ePub (1.7 MB)
在 iPhone、iPad、Android、Sony Reader 或 Windows Phone 上的各種應用程式中檢視
Mobi (Kindle) (1.6 MB)
在 Kindle 裝置或多部裝置的 Kindle 應用程式上檢視

已更新: 2024 年 7 月 25 日

文件 ID:222212

無偏見用語

本產品的文件集力求使用無偏見用語。針對本文件集的目的，無偏見係定義為未根據年齡、身心障礙、性別、種族身分、民族身分、性別傾向、社會經濟地位及交織性表示歧視的用語。由於本產品軟體使用者介面中硬式編碼的語言、根據 RFP 文件使用的語言，或引用第三方產品的語言，因此本文件中可能會出現例外狀況。深入瞭解思科如何使用包容性用語。

關於此翻譯

思科已使用電腦和人工技術翻譯本文件，讓全世界的使用者能夠以自己的語言理解支援內容。請注意，即使是最佳機器翻譯，也不如專業譯者翻譯的內容準確。Cisco Systems, Inc. 對這些翻譯的準確度概不負責，並建議一律查看原始英文文件（提供連結）。

簡介

本文檔介紹透過將JSON或XML資料格式與API呼叫結合使用，在Cisco ISE中配置內部使用者。

必要條件

ISE 3.0或更高版本。
API客戶端軟體。

採用元件

ISE 3.3
Insominia 9.3.2

本文中的資訊是根據特定實驗室環境內的裝置所建立。文中使用到的所有裝置皆從已清除（預設）的組態來啟動。如果您的網路運作中，請確保您瞭解任何指令可能造成的影響。

網路圖表

一般拓撲

GET和POST是API （應用程式程式設計介面）呼叫中最常用的兩種HTTP方法。它們用於與伺服器上的資源互動，通常用於檢索資料或提交資料以進行處理。

獲取API呼叫

GET方法用於從指定的資源請求資料。GET請求是API和網站中最常見且廣泛使用的方法。當您訪問網頁時，您的瀏覽器正在向託管該網頁的伺服器發出GET請求。

POST API呼叫

POST方法用於將資料傳送到伺服器以建立或更新資源。提交表單資料或上傳檔案時，經常會使用POST要求。

組態

我們需要從API客戶端軟體向ISE節點傳送確切資訊來建立內部使用者。

ISE配置

啟用ERS功能。

1. 切換作業選項至「管理」>「系統」>「設定」>「API設定」>「API服務設定」。

2. 啟用ERS （讀取/寫入）選項。

API設定

JSON請求。

開放性失眠。
在左側增加新的HTTPS請求。

JSON請求

您需要選擇POST以將資訊傳送到ISE節點。

您需要輸入的URL取決於ISE節點的IP地址。

URL： https://x.x.x.x/ers/config/internaluser

JSON帖子

然後按一下Body並選擇JSON

JSON本文

您可以貼上語法並根據需要變更引數。

JSON語法

{

  "InternalUser": {

    "name": "name",

    "description": "description",

    "enabled": true,

    "email": "email@domain.com",

    "accountNameAlias": "accountNameAlias",

    "password": "password",

    "firstName": "firstName",

    "lastName": "lastName",

    "changePassword": true,

    "identityGroups": "identityGroups",

    "passwordNeverExpires": false,

    "daysForPasswordExpiration": 60,

    "expiryDateEnabled": false,

    "expiryDate": "2016-12-11",

    "enablePassword": "enablePassword",

    "dateModified": "2015-12-20",

    "dateCreated": "2015-12-15",

    "customAttributes": {

      "key1": "value1",

      "key2": "value3"

    },

    "passwordIDStore": "Internal Users"

  }

}

按一下「驗證」並選擇「基本」。

JSON身份驗證

輸入ISE GUI憑證。

管理員JSON憑證

按一下標頭以新增下列方法：
- 內容型別：application/json
- 接受：application/json

JSON標頭

最後，按一下「傳送」。

注意：如果要將身份組分配給新使用者帳戶，需要使用身份組的ID。有關詳細資訊，請檢視故障排除部分。

驗證

傳送POST請求後，您將看到「201已建立」狀態。這表示程式已順利完成。

成功的JSON請求

打開ISE GUI並導航到Administration > Identity Management > Identities > Users > Network Access Users

JSON使用者帳戶

XML請求

開放性失眠。
在左側增加新的HTTPS請求。

XML請求

您需要選擇POST以將資訊傳送到ISE節點。

您需要輸入的URL取決於ISE節點的IP地址。

URL： https://x.x.x.x/ers/config/internaluser

XML文章

然後按一下「正文」並選擇「XML」。

XML正文

您可以貼上語法並根據需要變更引數。

XML文章

XML語法

<?xml version="1.0" encoding="UTF-8"?>

<ns0:internaluser xmlns:ns0="identity.ers.ise.cisco.com" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:ns1="ers.ise.cisco.com" xmlns:ers="ers.ise.cisco.com" description="description" name="name">

   <accountNameAlias>accountNameAlias</accountNameAlias>

   <changePassword>true</changePassword>

   <customAttributes>

      <entry>

         <key>key1</key>

         <value>value1</value>

      </entry>

      <entry>

         <key>key2</key>

         <value>value3</value>

      </entry>

   </customAttributes>

   <dateCreated>2015-12-15</dateCreated>

   <dateModified>2015-12-20</dateModified>

   <daysForPasswordExpiration>60</daysForPasswordExpiration>

   <email>email@domain.com</email>

   <enablePassword>enablePassword</enablePassword>

   <enabled>true</enabled>

   <expiryDate>2016-12-11</expiryDate>

   <expiryDateEnabled>false</expiryDateEnabled>

   <firstName>firstName</firstName>

   <identityGroups>identityGroups</identityGroups>

   <lastName>lastName</lastName>

   <password>password</password>

   <passwordIDStore>Internal Users</passwordIDStore>

   <passwordNeverExpires>false</passwordNeverExpires>

</ns0:internaluser>