Add OIDC browser approval and PKCE session handoff for pages CLI
This commit is contained in:
1 parent
336c5790e9
commit
f188e7eac1
3 files changed
+224
-9
No files matched your search
@@ -34,6 +34,34 @@ pages[default]:/manual> exit
|
||||
|
||||
`exit` はシェルを閉じるだけです。セッションを失効させる場合は `pages logout`。
|
||||
|
||||
### OIDCでログインする
|
||||
|
||||
OIDC連携を有効にしたDomainで利用します。サーバーとCLIの両方に **v0.3.0以降** が必要です。
|
||||
CLIのファイルだけを更新しても、v0.2.xのサーバーでは利用できません。
|
||||
|
||||
```sh
|
||||
pages configure --origin https://pages.example.test
|
||||
pages login --oidc
|
||||
# SSH先など、ブラウザを自動で開かない場合
|
||||
pages login --oidc --no-browser
|
||||
```
|
||||
|
||||
CLIに表示されたURLを手元のPC/スマホで開き、OIDCでログインします。
|
||||
続いてアカウント・接続先を確認し、ターミナルの確認コードを入力して承認します。
|
||||
ローカルTOTPを設定済みならTOTPも必要です。承認後はCLIが専用セッションを受け取ります。
|
||||
OIDCプロバイダーのパスワードやトークンをターミナルに入力する必要はありません。
|
||||
|
||||
ユーザー名の指定は省略できます。指定済みならブラウザで認証したユーザーとの一致を確認し、
|
||||
不一致時は発行セッションの失効を試みて保存しません。`pages logout` 後に設定を変更できます。
|
||||
リクエストは5分で失効します。Ctrl+Cはローカルの待機を終了し、未交換リクエストは期限で失効します。
|
||||
他人から送られたURL・コードでは承認しないでください。通信断で交換結果が不明な場合は自動再送せず、
|
||||
サーバのセッション管理で不要なセッションを確認・失効してからログインし直します。
|
||||
|
||||
`CLI OIDC login is unavailable on this server` は開始APIが利用できない場合の表示です。
|
||||
configureの接続先URLを確認し、サーバーも対応版へ更新してください。
|
||||
`OIDC login is not enabled for this domain` の場合は、対象DomainのOIDC設定を確認してください。
|
||||
`--no-browser` はブラウザーの自動起動だけを抑止し、承認待ちとセッション取得は通常どおり行います。
|
||||
|
||||
## 設定する
|
||||
|
||||
```sh
|
||||
@@ -94,7 +122,7 @@ pages edit /guide
|
||||
`pages --help`、`pages configure --help`、`pages edit --help` で引数を確認できます。
|
||||
Tab補完、上下キーのプロセス内履歴に対応。複雑な引用位置の補完、Ctrl+Pのfuzzy UIは後続です。
|
||||
|
||||
初期版は既存Page・既存言語の更新まで。新規作成、OIDC引き継ぎ、バイナリ更新は未実装です。
|
||||
初期版は既存Page・既存言語の更新まで。新規作成、バイナリ更新は未実装です。
|
||||
競合や通信断で自動上書きせず、ローカル原稿を保持します。HTTPS必須(開発用loopbackのみHTTP可)。
|
||||
詳しいURI・保存・安全性の契約は[設計書](../docs/design/ja/remote-cli.md)を参照してください。
|
||||
|
||||
|
||||
Reference in new issue
Block a user