Cisco DNA Centerと警子ちゃんを連携させてみた

# はじめに
この記事は[Cisco Systems Japan Advent Calendar 2023](https://qiita.com/advent-calendar/2023/cisco) のトップバッター(1日目)の記事です。
Advent Calender初投稿になります。


# Cisco DNA Centerと警子ちゃんを連携させてみた
以前に、評価機として貸し出していただいた警子ちゃんをDNACと連携できるモデルが正式に発売されたので既設のデモ環境に再度連携しましたので手順を記事にしてみました。

# Cisco DNA Centerとは？

CISCO DNACenterはCiscoのデジタルネットワークアーキテクチャの核となる統合管理プラットフォームです。ネットワークの自動化、インテリジェントな分析、ポリシーベースの管理を提供し、運用の効率化とセキュリティの強化を実現します。

https://www.cisco.com/site/jp/ja/products/networking/dna-center-platform/index.html

# 警子ちゃんとは？
警子ちゃんは、アイエスエイ社から発売されているUSB接続を使用してPCやサーバーに簡単に接続できるブザー付き警告灯です。このデバイスはブザー鳴動やランプの点灯・点滅を通じて、周囲にステータス情報を迅速に伝えることが可能です。GUIで操作できWindowsやLinuxシステムに対応しています。オフィス、工場、医療施設など多様な環境で利用されてます。

https://isa-j.co.jp/keiko/

# 環境＆構成図
・Cisco DNA Center 
・警子ちゃん DN-1700GXC

構成図

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3368717/6a995135-9687-098f-8294-e358100120b3.png)


# 連携手順
下記の4ステップで連携できました。

1. 警子ちゃんアドレス設定&HTTPコマンド制御機能の有効化
2. Cisco DNA Center Webhookの設定
3. Try-It Nowで警子ちゃんにWebhookが飛んでるか確認
4. Issueを発生させ警子ちゃん動作確認

# 1.警子ちゃんアドレス設定&HTTP制御機能の有効化
 1-1.基本設定＞LAN設定で疎通が取れるアドレス/デフォルトゲートウェイを設定する
※初期IP:192.168.1.1

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3368717/8e3a4a83-e2bc-f746-89de-0380a0e2929e.png)

1-2.HTTPコマンド制御機能を有効化
機器設定＞HTTPコマンド制御を有効化しておく

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3368717/0900ea31-9d05-abf4-da36-a0de3d8b0e33.png)

# 2.Cisco DNA Center Webhookの設定 

2-1.プラットフォーム＞開発者用ツールキットからWebhookを飛ばす設定の実施

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3368717/43c959e8-8309-7807-b874-069ff3c41058.png)

2-2.どのイベントが発生したらWebhookを飛ばすのか選択
今回は、[Interface Connecting Network Devices is Down]を選択します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3368717/e560e847-9ee6-a448-3723-948bce4f1b1f.png)

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3368717/845c149a-b18c-a36e-12c2-4ac948fbcc09.png)

2-3.警子ちゃん宛先をDNAC側に追加するために[here]押下し宛先の追加を行います

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3368717/2bf524e9-4c7b-0c98-0bc4-f5c0d7ba4d9f.png)

2-4.Webhookの宛先アドレスを設定
「追加」から宛先を作成

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3368717/d6d25ea0-ee0c-ed5d-f470-8fbab501a80b.png)

2-5.NameとURLを入力
※URLに[https://警子ちゃんのアドレス[(参照1-1)](#1警子ちゃんアドレス設定http制御機能の有効化))/api/control.php]と入力

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3368717/fc24e470-6be2-2624-bbca-ca4a375c4be3.png)

2-6. 2-3のタブに戻り作成した、先ほど作成した宛先を選択

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3368717/46ac3b08-8235-5b63-ded9-8a09caca7290.png)

2-7. NameとDescriptionを記入

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3368717/c4287d16-95bc-78c4-674e-b615351ea8fb.png)

「Finish」を押して、プラフォーム＞開発者用ツールキット追加されていれば設定完了

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3368717/aa5b1833-7d6a-321c-7ae6-78824af09292.png)


![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3368717/ded7b0b6-0d45-9f6c-6e01-61276eb872e5.png)

**※警子ちゃんはWebhook受信用の設定はありません。**


# 3. Try-It Nowで警子ちゃんにWebhookが飛んでるか確認

3-1. 開発者ツールキット＞EventCatalogから先ほど2-2で設定したイベントを参照し
NameとSeverityを確認

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3368717/f11b5db4-187d-823b-8115-a56f445ad5fb.png)

3-2. Try-It NowとPublishでWebhookを送信

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3368717/61fe234a-6b0c-13ec-7dac-d3f1f7a0cbf4.png)

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3368717/13835d1f-a430-7c27-e68a-7d799f80c96f.png)

SUCCESSになっていれば成功

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3368717/d3c61aa1-53cd-116f-d93a-54b51ada5038.png)

3-3. 警子ちゃん側でも受信されているか確認
DNAC受信制御設定の受信POSTにLOGが出てますね。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3368717/491ce0f9-04e8-378b-d6a7-fc3af36091dc.png)

シビリティも一致していることが確認できます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3368717/81057667-e554-e229-6564-9780bbf88c53.png)

※注意点「Try-It Now」では、["Assurance Issue Status"]が空欄で送られるため実際の警子ちゃんはランプの設定をしていても点灯しません。本来は"Assurance Issue Status"＝active→点灯、resolved→消灯のステータスとなります。

# 4. Issueを発生させ警子ちゃんの動作確認
4-1. ネットワーク機器側のポートをシャットダウン

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3368717/9eb2392f-886d-3858-1916-dc23a1922bba.png)

4-2. 警子ちゃんが通知をWebhookを受け取っていることを確認

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3368717/b4e5a505-b6da-648a-c2c4-6751106911cd.png)

実物の確認

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3368717/6e55dbff-9713-2ed6-7026-78fd027b8d7e.png)


# 最後に
Cisco DNA Centerと警子ちゃんの連携の手順をまとめることがきました。
Cisco DNA Centerはイベントの種類も多いので、シビリティごとにランプの点灯を分けることも可能ですね。




# ランプ/音声制御について（参考）

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3368717/0221192b-002f-de13-649a-90694d37b7dd.png)

■ランプ点灯パターン
０：消灯 １：点灯 ２：点滅 ３：高速点滅 X：設定なし

■ブザー音パターン
００：消音 １０：連続音 ０１：断続音 XX：設定なし

今回のランプ点灯赤、黄、緑　高速点灯させる場合
|赤  |黄  |緑  |ブザー音  |ブザー音  |未使用  |未使用  |未使用  |
|---|---|---|---|---|---|---|---|
|3  |3  |3  |x|x|0|0|0|

※DNACが同時にWebhookを送信した場合、警子ちゃんのランプ点灯はシビリティが一番高いものに包括されます。