セキュアアクセスAPIを使用したCurlによる通知先リストの管理

はじめに

このドキュメントでは、セキュアアクセスAPIを使用してcurlで宛先リストを管理する方法について説明します。

前提条件

要件

次の項目に関する知識があることが推奨されます。

• セキュアなアクセス
• セキュアアクセスAPI
• curl
• Json

使用するコンポーネント

このドキュメントの情報は、次のソフトウェアとハードウェアのバージョンに基づいています。

• セキュアなアクセス
• セキュアアクセスAPI
• curl
• Json

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

設定

1.APIキーの作成 

Secure Access Dashboardに移動します。

• Admin > Api Keys >をクリックします。 Add


APIキー1の作成APIキーの作成2

• 必要に応じてAPI Key Name、Description (Optional)、Expiry Dateを追加します

APIキーの作成3

• の下で Key Scope、「Expand policies」を選択Policiesします。 
• とを選択Destination Lists。 Destinations
• 必要に応じて変更Scope、それ以外の場合は Read/Write
• クリック CREATE KEY

APIキーの作成4

• とAPI KeyをコピーしKey Secretて、 ACCEPT AND CLOSE

  

APIキーの作成5

2. APIアクセストークンの生成

APIアクセストークンを生成するには、トークン認証要求を作成します。

トークン許可要求

組織で作成したSecure Access APIクレデンシャルを使用して、APIアクセストークンを生成します。

• curlの例では、Secure Access APIのキーとシークレットを置き換えます

curl --user key:secret --request POST --url https://api.sse.cisco.com/auth/v2/token -H Content-Type: application/x-www-form-urlencoded -d grant_type=client_credentials

• 生成されたBearer APIトークンをコピーして保存する

3.通知先リストの管理

宛先リストを管理する方法は複数あり、次のようなものがあります。

すべての通知先リストの取得

WindowsコマンドプロンプトまたはMacターミナルを開いてコマンドを実行します。

curl -L --location-trusted --request GET --url https://api.sse.cisco.com/policies/v2/destinationlists -H "Authorization: Bearer YourAccessToken" -H "Content-Type: application/json"

出力例のスニペット：

{"id":23456789,"organizationId":1234567,"access":"none","isGlobal":false,"name":" Test Block list","thirdpartyCategoryId":null,"createdAt":1694070823,"modifiedAt":1702819637,"isMspDefault":false,"markedForDeletion":false,"bundleTypeId":2,"meta":
{"destinationCount":2,"domainCount":2,"urlCount":0,"ipv4Count":0,"applicationCount":0}

出力の「id」フィールドの下にリストされているdestinationListIdを書き留めます。このフィールドは、この宛先リストに固有のGET、POST、またはDELETE要求にさらに使用されます。

通知先リスト内のすべての通知先を取得する

• 前述の手順destinationListId「すべての宛先リストの取得」を使用して取得します。

WindowsコマンドプロンプトまたはMacターミナルを開いてコマンドを実行します。

curl -L --location-trusted --request GET --url https://api.sse.cisco.com/policies/v2/destinationlists/destinationListId/destinations -H "Authorization: Bearer YourAccessToken" 

 出力例：

{"status":{"code":200,"text":"OK"},"meta":{"page":1,"limit":100,"total":3},"data":
[
{"id":"415214","destination":"cisco.com","type":"domain","comment":null,"createdAt":"2024-02-20 09:15:46"},{"id":"7237895","destination":"www.cisco.com","type":"domain","comment":null,"createdAt":"2024-02-20 10:19:51"},{"id":"29275814","destination":"10.10.10.10","type":"ipv4","comment":null,"createdAt":"2024-02-20 09:15:46"},{"id":"71918495","destination":"www.subdomain.cisco.com/resoucre","type":"url","comment":null,"createdAt":"2024-02-20 10:29:02"}
]}

新しい通知先リストの作成

WindowsコマンドプロンプトまたはMacターミナルを開いてコマンドを実行します。

curl -L --location-trusted --request POST --url https://api.sse.cisco.com/policies/v2/destinationlists -H "Authorization: Bearer YourAccessToken" -H "Content-Type: application/json" -H "Accept: application/json" -d "{\"access\":\"none\",\"isGlobal\":false,\"name\":\"Destination List Name\"}"

出力例：

{"id":23456789,"organizationId":1234567,"access":"none","isGlobal":false,"name":"API List 1","thirdpartyCategoryId":null,"createdAt":1708417690,"modifiedAt":1708417690,"isMspDefault":false,"markedForDeletion":false,"bundleTypeId":1,"meta":{"destinationCount":0}}

通知先リストへの通知先の追加

• 前述の手順destinationListId「すべての宛先リストの取得」を使用して取得します。

WindowsコマンドプロンプトまたはMacターミナルを開いてコマンドを実行します。

curl -L --location-trusted --request POST --url https://api.sse.cisco.com/policies/v2/destinationlists/{destinationListId}/destinations -H "Authorization: Bearer YourAccessToken" -H "Content-Type: application/json" -d "[{\"destination":"cisco.com\"},{\"destination\":\"10.10.10.10\"},{\"destination\":\"www.subdomain.cisco.com\/resource\"}]"

出力例：

{"status":{"code":200,"text":"OK"},"data":{"id":17804929,"organizationId":1234567,"access":"none","isGlobal":false,"name":"API List 1","thirdpartyCategoryId":null,"createdAt":1708417690,"modifiedAt":1708420546,"isMspDefault":false,"markedForDeletion":false,"bundleTypeId":1,"meta":
{"destinationCount":3}}}

通知先リストの削除

• 前述の手順destinationListId「すべての宛先リストの取得」を使用して取得します。

WindowsコマンドプロンプトまたはMacターミナルを開いてコマンドを実行します。

curl -L --location-trusted --request DELETE --url https://api.sse.cisco.com/policies/v2/destinationlists/destinationListId -H "Authorization: Bearer YourAccessToken"​

出力例：

{"status":{"code":200,"text":"OK"},"data":[]}

通知先リストからの通知先の削除

• 前述の手順destinationListId「すべての宛先リストの取得」を使用して取得します。
• 前述の手順「id宛先リスト内のすべての宛先を取得する」を使用して、削除する必要があるリスト内の特定の宛先のアドレスを取得します。

WindowsコマンドプロンプトまたはMacターミナルを開いてコマンドを実行します。

curl -L --location-trusted --request DELETE --url https://api.sse.cisco.com/policies/v2/destinationlists/destinationListId/destinations/remove -H "Authorization: Bearer YourAccessToken" -H "Content-Type: application/json" -H "Accept: application/json" -d "[id1,id2]"

出力例：

{"status":{"code":200,"text":"OK"},"data":{"id":17804929,"organizationId":1234567,"access":"none","isGlobal":false,"name":"API List 1","thirdpartyCategoryId":null,"createdAt":1708417690,"modifiedAt":1708525645,"isMspDefault":false,"markedForDeletion":false,"bundleTypeId":1,"meta":{"destinationCount":2}}}

トラブルシュート

Secure Access APIエンドポイントは、HTTP応答コードを使用してAPI要求の成功または失敗を示します。一般に、2xxの範囲のコードは成功を示し、4xxの範囲のコードは提供された情報に起因するエラーを示し、5xxの範囲のコードはサーバエラーを示します。この問題を解決するアプローチは、受信した応答コードによって異なります。

REST API：応答コード1

REST API：応答コード2また、APIに関連するエラーや問題のトラブルシューティングを行う際には、次のレート制限に注意する必要があります。

• セキュアアクセスAPIの制限

関連情報

• Cisco Secure Accessユーザガイド
• シスコテクニカルサポートおよびダウンロード
• セキュアアクセスAPIキーの追加
• 開発者ユーザガイド