テストに使う Clientは curlから Postmanへ

Slide 1

Slide 1 text

テストに使う Clientは curlから Postmanへ CTCテクノロジー株式会社森岡延史

Slide 2

Slide 2 text

前置き本日話す内容は私個人の見解や意見に基づいたものです。私が所属している会社や組織の公式見解を代表するものではありません。この資料の内容は私個人の意見であり、所属組織とは一切関係ありません。初めに

Slide 3

Slide 3 text

自己紹介名前：森岡延史（もりおかのぶひと）所属：CTCテクノロジー株式会社職種：ハイレイヤー系ネットワーク製品の社内バックサポート，トラシュー，ベンダー問い合わせ肩書：エキスパートエンジニア趣味：サバイバルゲーム初めに

Slide 4

Slide 4 text

curlは非常に強力で素晴らしいツールです。でもそれを一度捨てて Postmanを使ってみてはいかがでしょうか。第一部：curlを使っているけれど・・・第二部：Postmanに変えてみた。第三部：ちょっと変わった（？）使い方本日話す内容初めに

Slide 5

Slide 5 text

第一部：curlを使っているけれど・・・

Slide 6

Slide 6 text

社名：CTCテクノロジー株式会社株主：伊藤忠テクノソリューションズ株式会社（100%）業務：コンピュータシステムの設置及びメンテナンス設計・構築システム運用管理、障害監視技術的コンサルティング技術トレーニング，スクール所属会社について第一部：curlを使っているけれど・・・全国にサービス拠点社員数約1,700名

Slide 7

Slide 7 text

扱っている製品の例所属会社について第一部：curlを使っているけれど・・・ハードウェアサーバ Cisco、Dell EMC、富士通、HPE、Huawei、IBM、Infoblox、Oracle Sun、Stratus ストレージ Dell EMC、富士通、日立、HPE、Huawei、NetApp、Oracle、PureStorage ネットワーク A10、ALAXALA、Allot、APRESIA、Arista、Aruba、AVAYA、Brocade、Cisco、Citrix、 F5、Fortinet、Huawei、Juniper、Palo Alto、Radware、YAMAHA セキュリティ BlueCoat、Palo Alto HCI HPE Simplivity、Nutanix NXシリーズ APIにあまり関係ないように見えるかもしれません。

Slide 8

Slide 8 text

近年、運用統合や自動化， Infrastructure as Code（IaC）といった文脈で、取り扱っている製品に APIが実装されるようになりました。その結果、APIの仕様にかかわる質問や動作のトラブルシューティングに対応する機会が生まれました。 APIとの関わりについて第一部：curlを使っているけれど・・・

Slide 9

Slide 9 text

私が関わっている多くの機器で APIはHTTP/HTTPSで実装されています。それらのマニュアルではcurlを使って操作をする例が書かれています。 curlで動かすことはできるけれど、 curlだとしんどいことも分かってきました。 curlを使ってAPIを触っているけれど・・・第一部：curlを使っているけれど・・・とある製品での設定例

Slide 10

Slide 10 text

マニュアルからのURLのコピペや、認証で得られるSecretのコピペを何度もするのがしんどい。コピペがしんどい第一部：curlを使っているけれど・・・メモ帳にコピペメモ帳でコマンド作成コピペして実行

Slide 11

Slide 11 text

毎日APIに関わっている訳ではありません。いざ触るときにcurlのオプションが分からず、毎回検索していました。オプションがしんどい第一部：curlを使っているけれど・・・

Slide 12

Slide 12 text

検証結果のエビデンスを求められたり別の条件でのテストが必要になると、記憶を頼りにコマンドを作って再試験していました。再試験がしんどい第一部：curlを使っているけれど・・・

Slide 13

Slide 13 text

ミートアップに参加したことで、テストに使うClientをPostmanに変えました。ツールを変えよう第一部：curlを使っているけれど・・・

Slide 14

Slide 14 text

第二部：Postmanに変えてみた。

Slide 15

Slide 15 text

Postmanの初期操作第二部：Postmanに変えてみた。ユーザー登録をしてログインした状態

Slide 16

Slide 16 text

Postmanの初期操作第二部：Postmanに変えてみた。 APIや実施内容ごとに枠組みを作成

Slide 17

Slide 17 text

Postmanの初期操作第二部：Postmanに変えてみた。 APIへのリクエストを作成

Slide 18

Slide 18 text

Postmanの初期操作第二部：Postmanに変えてみた。リクエスト内容を作って Sendを押して、テスト実行

Slide 19

Slide 19 text

実行するリクエストを保存できるので、マニュアルからのコピペの頻度を少なくできます。リクエスト保存でコピペ解消第二部：Postmanに変えてみた。

Slide 20

Slide 20 text

レスポンスからSecret情報を自動で環境変数に取り込んで再利用できます。スクリプトでコピペ解消第二部：Postmanに変えてみた。レスポンスに対してスクリプトを実行 Secret情報を自動で環境変数に取り込み

Slide 21

Slide 21 text

レスポンスからSecret情報を自動で環境変数に取り込んで再利用できます。スクリプトでコピペ解消第二部：Postmanに変えてみた。取り込んだSecret情報をリクエストで再利用

Slide 22

Slide 22 text

使いたいメソッドやヘッダ、ボディを指定する箇所が分かりやすい。オプションの学習が不要第二部：Postmanに変えてみた。メソッドの選択ヘッダの設定ボディの設定

Slide 23

Slide 23 text

リクエストがHistoryに残るので、内容を参照したり再利用したりできます。過去の試験内容が見られる第二部：Postmanに変えてみた。 History機能過去に送信したリクエストを読み出して確認可能

Slide 24

Slide 24 text

リクエストがHistoryに残るので、内容を参照したり再利用したりできます。過去の試験内容が見られる第二部：Postmanに変えてみた。読みだしたリクエストは送信や保存可能

Slide 25

Slide 25 text

私のように毎日APIを触るという訳でない人にとって、curlは再学習コストが高いツールだと感じました。 Postmanを繰り返し使うことで、より高い効率化が期待できます。 Freeプランがあるので気軽に使ってみましょう。 Postmanを使ってみて第二部：Postmanに変えてみた。

Slide 26

Slide 26 text

従来使っていたコマンドをインポートしてPostmanで使えます。 curlコマンドのインポート機能第二部：Postmanに変えてみた。コマンドをコピペ

Slide 27

Slide 27 text

コマンドを自動で解釈してリクエストを作成 curlコマンドのインポート機能第二部：Postmanに変えてみた。

Slide 28

Slide 28 text

第三部：ちょっと変わった（？）使い方

Slide 29

Slide 29 text

HTTP/1.1で実装された機能に Keep-aliveがあります。 1つのセッションの中で複数のリクエストを送信するものでClientとServer間のやり取りが効率的になります。一方でServerの設定を変更しても既存セッションではその変更が反映されず、テストにおいて手動でのセッション切断が必要になる場合がありました。 Keep-aliveを無効化する第三部：ちょっと変わった（？）使い方

Slide 30

Slide 30 text

HeaderにてConnection closeとすることでKeep-aliveを無効化できます。 Keep-aliveを無効化する第三部：ちょっと変わった（？）使い方

Slide 31

Slide 31 text

特定URLへのリクエストにおいてClient証明書と秘密鍵を使う設定を行います。 HTTPSのClient証明書認証を行う第三部：ちょっと変わった（？）使い方設定を開きます

Slide 32

Slide 32 text

第三部：ちょっと変わった（？）使い方特定URLへのリクエストにおいてClient証明書と秘密鍵を使う設定を行います。 HTTPSのClient証明書認証を行う証明書の設定を開きます証明書の追加を開きます

Slide 33

Slide 33 text

第三部：ちょっと変わった（？）使い方特定URLへのリクエストにおいてClient証明書と秘密鍵を使う設定を行います。 HTTPSのClient証明書認証を行う接続先のURLと使用する Client証明書/秘密鍵を指定して追加

Slide 34

Slide 34 text

PostmanでClient証明書認証ができました。 HTTPSのClient証明書認証を行う第三部：ちょっと変わった（？）使い方

Slide 35

Slide 35 text

設定にて、無効化するTLSバージョンや使用するCipherの限定ができます。 HTTPSで使用するTLS/Cipherを指定する第三部：ちょっと変わった（？）使い方

Slide 36

Slide 36 text

設定にて、無効化するTLSバージョンや使用するCipherの限定ができます。 HTTPSで使用するTLS/Cipherを指定する第三部：ちょっと変わった（？）使い方この場合 TLS1.1を使い、 CipherはRSA関連を使う

Slide 37

Slide 37 text

PostmanをAPIのテストをするツールとしてだけでなく、 HTTP/HTTPSを柔軟に扱えるツールととらえると、利用できるシーンが増えます。本日紹介した内容はあくまでも一例です。 Postmanを利活用しましょう。 Postmanが使えるのはAPIに対してだけじゃない第三部：ちょっと変わった（？）使い方

Slide 38

Slide 38 text

ありがとうございました。