Insominiaを使用したISE 3.3でのJSONまたはXMLおよびAPIコールによる内部ユーザの設定

ダウンロードオプション

PDF (1.9 MB)
Adobe Reader を使ってさまざまなデバイスで表示
ePub (1.7 MB)
iPhone、iPad、Android、ソニーの Reader、または Windows Phone 上で、さまざまなアプリを使って表示
Mobi (Kindle) (1.6 MB)
Kindle デバイスで、または Kindle アプリを使って複数のデバイスで表示

Updated: 2024 年 7 月 25 日

Document ID:222212

偏向のない言語

この製品のドキュメントセットは、偏向のない言語を使用するように配慮されています。このドキュメントセットでの偏向のない言語とは、年齢、障害、性別、人種的アイデンティティ、民族的アイデンティティ、性的指向、社会経済的地位、およびインターセクショナリティに基づく差別を意味しない言語として定義されています。製品ソフトウェアのユーザインターフェイスにハードコードされている言語、RFP のドキュメントに基づいて使用されている言語、または参照されているサードパーティ製品で使用されている言語によりドキュメントに例外が存在する場合があります。シスコのインクルーシブランゲージの取り組みの詳細は、こちらをご覧ください。

翻訳について

シスコは世界中のユーザにそれぞれの言語でサポートコンテンツを提供するために、機械と人による翻訳を組み合わせて、本ドキュメントを翻訳しています。ただし、最高度の機械翻訳であっても、専門家による翻訳のような正確性は確保されません。シスコは、これら翻訳の正確性について法的責任を負いません。原典である英語版（リンクからアクセス可能）もあわせて参照することを推奨します。

内容

はじめに

このドキュメントでは、APIコールと組み合わせてJSONまたはXMLデータ形式を活用することにより、Cisco ISEの内部ユーザを設定する方法について説明します。

前提条件

ISE 3.0以降。
APIクライアントソフトウェア。

使用するコンポーネント

ISE 3.3
Insominia 9.3.2

このドキュメントの情報は、特定のラボ環境にあるデバイスに基づいて作成されました。このドキュメントで使用するすべてのデバイスは、クリアな（デフォルト）設定で作業を開始しています。本稼働中のネットワークでは、各コマンドによって起こる可能性がある影響を十分確認してください。

ネットワーク図

一般的なトポロジ

GETとPOSTは、API（アプリケーションプログラミングインターフェイス）呼び出しで使用される最も一般的なHTTPメソッドの2つです。サーバ上のリソースとの対話に使用され、通常はデータを取得したり、処理のためにデータを送信したりします。

GET APIコール

GETメソッドは、指定されたリソースからデータを要求するために使用します。GET要求は、APIおよびWebサイトで最も一般的で広く使用されているメソッドです。Webページにアクセスすると、ブラウザはWebページをホストしているサーバに対してGET要求を行います。

POST APIコール

POSTメソッドは、リソースを作成または更新するためにサーバーにデータを送信するために使用します。POST要求は、フォームデータの送信やファイルのアップロードによく使用されます。

コンフィギュレーション

内部ユーザを作成するには、APIクライアントソフトウェアからISEノードに正確な情報を送信する必要があります。

ISEの設定

ERS機能を有効にします。

1. [管理] > [システム] > [設定] > [API設定] > [APIサービス設定]に移動します。

2. ERS（読取り/書込み）オプションを使用可能にします。

API設定

JSON要求。

オープン不眠症。
左側に新しいHTTPS要求を追加します。

JSON要求

ISEノードに情報を送信するには、POSTを選択する必要があります。

入力する必要がある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 protected]",

    "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"

  }

}

Authをクリックし、Basicを選択します。

JSON認証

ISE GUIクレデンシャルを入力します。

管理者JSON資格情報

「ヘッダー」をクリックして、次のメソッドを追加します。
- Content-Type:application/json
- 許可：アプリケーション/json

JSONヘッダー

最後に、Sendをクリックします。

注：新しいユーザアカウントにIDグループを割り当てる場合は、そのIDを使用する必要があります。詳細については、「トラブルシューティング」の項を参照してください。

検証

POST要求を送信すると、「201 Created」というステータスが表示されます。これは、プロセスが正常に完了したことを意味します。

成功したJSON要求

ISE GUIを開き、Administration > Identity Management > Identities > Users > Network Access Usersの順に移動します

JSONユーザーアカウント

XML要求

オープン不眠症。
左側に新しいHTTPS要求を追加します。

XML要求

ISEノードに情報を送信するには、POSTを選択する必要があります。

入力する必要があるURLは、ISEノードのIPアドレスによって異なります。

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

XML投稿

次に、Bodyをクリックして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 protected]</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>