2020-09-21

REST APIを使ってユーザ登録を半自動化する

目的
アプライアンス製品を扱っていると、ユーザ登録まで行った状態でお客様へ納品することがあると思います。今回は、大量のユーザ登録を行わなければならなくなった時を想定し、REST APIでのユーザ登録機能を利用してユーザ登録を半自動化することが目的です。
※以降は素人の浅知恵で考えたものですのでご注意ください。
環境
・Cisco DEVNET Sandbox のStealthwatch
・Windows10
・Excel
・curl（Windows10に標準でインストールされているもの)
・コマンドプロンプト
想定フロー
（1）Excelでユーザ管理表を作成（ユーザ名、パスワード、ロールなどのパラメータ管理表）
（2）Excelからjsonファイルを生成する
（3）batファイルを実行し、REST APIの実行(REST APIの引数としてjsonを指定）
※今回は（３）の部分をとりあげます
batファイルの中身

curl -s -k -c cookies.txt -d "username=ユーザ名&password=パスワード" https://IPアドレス/token/v2/authenticate

for %%i in (*.json) do (

curl -k -b cookies.txt -H "Content-type: application/json" -X POST --data "@%%i" https://IPアドレス/smc-users/rest/v1/user

)

pause

1行目では認証を行っています。
3行目以降ではbatファイルが存在するフォルダにある「.json」ファイルの数だけユーザ登録処理を実行しています。
4行目では、「--data "@%%i"」を指定することで、フォルダに存在するjsonファイル名をREST APIに引き渡しています。ここでポイントとなるのは、json形式で直接記述するのではなく、jsonファイルを引数に指定していることです。
jsonファイルの中身
jsonファイルの中身は以下のようになっています。

{

  "userName": "test2",

  "fullName": "test2",

  "emailAddress": "",

  "authenticationServiceName": "local",

  "dataRoleId": 0,

  "functionRoleIds": [0],

  "webFunctionRoleIds": [1],

  "password": "パスワード",

  "isAdmin": true

}
参考資料

Cisco DevNet: APIs, SDKs, Sandbox, and Community for Cisco Developers

https://developer.cisco.com/docs/stealthwatch/enterprise/#!user-management-api

qiita.com
愚痴
StealthwatchのREST APIのドキュメントが分かりにくかった。
StealthwatchのREST APIのドキュメントは以下のような感じ。最初はユーザ管理のREST APIのURLが分かりませんでした。。。

で、どこにURLが書いてあるかというと、上記画像にある「GET」とか「POST」のところをクリックすると出てくる以下の画面の「Try it」を選択した後に表示される画面に書いてあった。。
余談
jsonファイルに複数ユーザー書いておけば、一気に登録できるかと思ったけど、できなかった。REST APIが1ユーザずつの登録にしか対応していないかもしれない。（それかjsonの書き方が悪かった？）
とりあえずは、batで複数ファイルを繰り返し処理するようにして解決した。

2020-04-19

英語技術書の電子書籍(epub)から日本語訳した電子書籍を作る方法

需要はほとんどないと思いますが、現状英語版しか存在しない「CCNP and CCIE Enterprise Core ENCOR 350-401 Official Cert Guide」を例にして、日本語訳した電子書籍を作成する方法(私なりの)について書きます。

なお、本記事中に出てくる画像中に出てくる書籍の内容は「CCNP and CCIE Enterprise Core ENCOR 350-401 Official Cert Guide」より引用したものです。

【用意するもの】

・PC

・epub作成/編集ソフト Sigil Ebook

・Sigil Ebookと連携してepubを編集できるWYSIWYGエディターPageEdit

・編集したい電子書籍(epub)

※Sigil EbookとPageEditは以下が公式サイト

sigil-ebook.com

【手順】

Sigil Ebookのファイルメニューから「開く」を選択する
ブックブラウザーで編集したい.xhtmlファイルをダブルクリックして開く。ちなみにOfficial Cert Guideの場合は、「chXX.xhtml」(XXは章番号)が各章のファイルになっています。
外部xhtmlエディターを起動ボタンを押して、PageEditを起動する
なお、事前に設定で外部xhtmlエディタを指定しておく必要があります。
PageEditが起動するとepubをビューアで表示したときと同様に表示されます。
※「CCNP and CCIE Enterprise Core ENCOR 350-401 Official Cert Guide Chapter 1. Packet Forwadingより引用」
英文をDeepL翻訳やGoogle翻訳で日本語に訳し、意味の通じる文章でなければ修正して英語を上書き。
PageEditで保存すると、Sigil Ebookに内容が反映される。Sigil Ebookでも保存すると、epubファイルが上書きされる。