Add invocation-scoped TLS verification bypass for self-signed servers
This commit is contained in:
1 parent
7fa71eceb1
commit
59ab4c5b26
9 files changed
+206
-15
No files matched your search
@@ -36,6 +36,25 @@ pages[default]:/manual> exit
|
||||
|
||||
`exit` はシェルを閉じるだけです。セッションを失効させる場合は `pages logout`。
|
||||
|
||||
### 自己署名証明書の環境に接続する
|
||||
|
||||
v0.2.0以降では、グローバルオプション `--insecure`(`-k`)を**コマンドの前**に指定すると、その実行中だけTLS証明書とホスト名の検証をスキップできます。既定では必ず検証し、設定・セッションにはスキップ状態を保存しません。
|
||||
|
||||
```sh
|
||||
pages configure --origin https://wiki.example.test --username YOUR_USERNAME
|
||||
pages --insecure login
|
||||
pages -k task list
|
||||
pages -k edit /guide --lang ja
|
||||
pages -k # この対話シェルの終了まで適用
|
||||
pages -k logout
|
||||
```
|
||||
|
||||
指定のたびに標準エラーへ警告を表示します。標準出力のJSONやNeoMutt宛先候補には混ぜません。次のコマンドでは、必要なら改めて `-k` を付けます。`configure` は通信しないため `-k configure` は拒否します。
|
||||
|
||||
**自己署名証明書だけでなく、期限切れやホスト名不一致も許容します。通信は暗号化されますが、相手の真正性を確認できず、中間者攻撃でパスワード・Bearer・文書等を盗み見られる危険があります。** 信頼できる検証環境でのみ明示指定し、常用する環境では信頼するCAをOSへ登録して通常の検証を使ってください。遠隔HTTP、リダイレクト追従、TLS失敗時の自動再送は引き続き許可しません。
|
||||
|
||||
OIDCでは `pages -k login --oidc --no-browser` のように指定できます。ただし、スキップするのはCLIのHTTPS要求のみです。開いたブラウザやOIDCプロバイダーの証明書検証は変更しません。
|
||||
|
||||
### OIDCでログインする
|
||||
|
||||
OIDC連携を有効にしたDomainで利用します。サーバーは **v0.3.0以降** が必要です。独立版CLI v0.1.0は対応済みです(分離前のCLIではサーバー同梱版v0.3.0以降)。
|
||||
@@ -150,10 +169,10 @@ pages edit /guide --lang en # 英語版。未作成なら既存内容から
|
||||
## テスト
|
||||
|
||||
```sh
|
||||
python3 -m unittest test_pages test_productivity test_distribution
|
||||
python3 -m unittest test_pages test_productivity test_distribution test_tls
|
||||
```
|
||||
|
||||
合成サーバーと一時ディレクトリのみを使用します。本番資格情報や外部カレンダーは不要です。Goサーバーとの結合テストはサーバーリポジトリ側で実行します。
|
||||
合成サーバーと一時ディレクトリのみを使用します。TLS試験には一時証明書を生成するOpenSSLコマンドが必要です。本番資格情報や外部カレンダーは不要です。Goサーバーとの結合テストはサーバーリポジトリ側で実行します。
|
||||
## タスクと連絡先
|
||||
|
||||
`pages task --help` で作成・計画・開始/終了・レポートを操作できる。
|
||||
|
||||
Reference in new issue
Block a user