メール構成コマンド
ワンタイム共有や通知送信のためのメールプロバイダ構成を管理
概要
email-config コマンドは、コマンダーから直接ワンタイム共有リンクや通知を送信するために使用されるメールプロバイダの構成を管理します。構成はKeeperボルト内に暗号化されて保存されます。コマンダーを通じて安全なメールを送信することで、ゼロ知識が維持され、Keeperのバックエンドサーバーはコンテンツにアクセスできません。
対応プロバイダ
SMTP - すべてのインストールで利用可能 (バイナリ、pip、[email]付きpip)
SendGrid -
pip install keepercommander[email]でのみ利用可能AWS SES -
pip install keepercommander[email]でのみ利用可能Gmail OAuth -
pip install keepercommander[email]でのみ利用可能Microsoft OAuth -
pip install keepercommander[email]でのみ利用可能
バイナリインストールおよび基本的なpipインストール pip install keepercommander はSMTPのみに対応しています。
活用事例
メール構成は、Keeperのサーバー経由でメールを送信する代わりに、顧客が構成したメールプロバイダを使用して、コマンダーから直接メールを送信する場合に使用されます。以下の事例が活用できます。
record-addコマンドでワンタイム共有リンクを送信pam action rotateコマンドでパスワードをローテーションしワンタイム共有を送信credential-provisionコマンドで新入社員の認証情報のローテーションと配布を自動化
メール構成コマンド
email-config create
コマンド: email-config create
詳細: 新しいメールプロバイダ構成を作成します。構成はKeeperボルト内に暗号化されて保存され、record-add および one-time-share コマンドと併用できます。
共通パラメータ
--name <NAME>- 構成名 (必須)--provider <PROVIDER>- プロバイダ種別:smtp,sendgrid,aws-ses,gmail-oauth,microsoft-oauth(必須)--from-address <EMAIL>- 送信元メールアドレス (必須)--from-name <NAME>- 送信者表示名 (任意)
SMTPプロバイダのパラメータ
--smtp-host <HOST>- SMTPサーバーのホスト名--smtp-port <PORT>- SMTPサーバーのポート (デフォルト: 587)--smtp-username <USERNAME>- SMTPユーザー名--smtp-password <PASSWORD>- SMTPパスワード--smtp-use-tls <ON|OFF>- TLSを有効化 (デフォルト: ON)
SendGridプロバイダのパラメータ
--sendgrid-api-key <KEY>- SendGrid APIキー
AWS SESプロバイダのパラメータ
--aws-region <REGION>- AWSリージョン (例: us-east-1)--aws-access-key-id <KEY>- AWSアクセスキーID--aws-secret-access-key <SECRET>- AWSシークレットアクセスキー
OAuthプロバイダのパラメータ (GmailおよびMicrosoft)
--oauth-client-id <ID>- OAuthクライアントID--oauth-client-secret <SECRET>- OAuthクライアントシークレット--oauth-tenant-id <ID>- AzureテナントID (Microsoftのみ。マルチテナントの場合は「common」を使用)--oauth-port <PORT>- ローカルコールバックポート (デフォルト: 8080)
OAuth手動トークンパラメータ (上級者向け)
--oauth-access-token <TOKEN>- アクセストークン--oauth-refresh-token <TOKEN>- リフレッシュトークン--oauth-token-expiry <DATETIME>- トークン有効期限 (ISO-8601形式)
例
# GmailのSMTP
email-config create \
--name 'SMTP-Gmail' \
--provider smtp \
--from-address '[email protected]' \
--from-name 'Your Name' \
--smtp-host 'smtp.gmail.com' \
--smtp-port 587 \
--smtp-use-tls 'true' \
--smtp-use-ssl 'false' \
--smtp-username '[email protected]' \
--smtp-password 'app-password'
# SendGrid
email-config create \
--name 'SendGrid' \
--provider sendgrid \
--from-address '[email protected]' \
--sendgrid-api-key 'SG.xxx'
# Gmail OAuth（対話型フロー）
email-config create \
--name 'Gmail-OAuth' \
--provider gmail-oauth \
--from-address '[email protected]' \
--oauth-client-id 'YOUR_CLIENT_ID.apps.googleusercontent.com' \
--oauth-client-secret 'YOUR_CLIENT_SECRET'
# Microsoft OAuth
email-config create \
--name 'Microsoft-OAuth' \
--provider microsoft-oauth \
--from-address '[email protected]' \
--oauth-client-id 'YOUR_APPLICATION_ID' \
--oauth-client-secret 'YOUR_CLIENT_SECRET' \
--oauth-tenant-id 'YOUR_TENANT_ID'
# AWS SES
email-config create \
--name 'AWS-SES' \
--provider aws-ses \
--from-address '[email protected]' \
--aws-region 'us-east-1' \
--aws-access-key-id 'AKIA...' \
--aws-secret-access-key 'xxx'SMTPの例は、アプリパスワード認証を用いたGmailのSMTPサーバーを使用します。ポート587で「Use TLS」を「true」に設定するか、ポート465で「Use SSL」を「true」に設定してください。
SendGridは、検証済み送信ドメインとAPIキーが必要です
Gmail OAuthは認可のためにブラウザを開きます (トークンはボルトに保存)
Microsoft OAuthはシングルテナントおよびマルチテナント構成をサポートします
AWS SESは、SESの送信権限を持つIAM認証情報が必要です
email-config list
コマンド
email-config list
詳細
構成済みのメールプロバイダをすべて基本情報とともに表示します。
例
email-config list出力
Email Configurations:
Name Provider From Address
─────────────────────────────────────────────────────────
Gmail-OAuth gmail-oauth [email protected]
SMTP-Office365 smtp [email protected]
SendGrid-Main sendgrid [email protected]email-config test
コマンド
email-config test <NAME>
詳細
接続と認証を検証してメール構成をテストします。任意でテストメールを送信できます。
パラメータ
<NAME>- テストする構成名--send-to <EMAIL>- 指定したアドレスにテストメールを送信（任意）
例
# 接続のみをテスト（メールは送信されません）
email-config test 'Gmail-OAuth'
# 実際にテストメールを送信
email-config test 'Gmail-OAuth' --send-to '[email protected]'出力 (接続テスト)
Testing connection for "Gmail-OAuth" (gmail-oauth)...
[EMAIL] Gmail OAuth connection successful: [email protected]
✓ Connection test successful for "Gmail-OAuth"出力 (--send-to)
Testing connection for "Gmail-OAuth" (gmail-oauth)...
[EMAIL] Sending test email to [email protected]...
[EMAIL] Test email sent successfully
✓ Connection test successful for "Gmail-OAuth"email-config delete
コマンド
email-config delete <NAME>
詳細
Keeperボルトからメール構成を削除します。
パラメータ
<NAME>- 削除する構成名
例
email-config delete 'Old-SMTP-Config'email-config update
コマンド
email-config update <NAME> [OPTIONS]
詳細
既存のメール構成を更新します。次と同じパラメータを受け付けます create コマンド。
パラメータ
<NAME>- 更新する構成名[OPTIONS]- 次と同じオプション:createコマンド
例
# SMTPパスワードを更新
email-config update 'SMTP-Gmail' --smtp-password 'new-app-password'
# 送信者名を更新
email-config update 'Gmail-OAuth' --from-name 'New Display Name'メール構成の使用
メール構成は、メール配信をサポートするコマンドと一緒に使用します。
record-add を使用する場合
record-add --record-type login \
--title 'Server Access' \
login=admin \
password=$GEN \
--self-destruct 24h \
--email-config 'Gmail-OAuth' \
--send-email '[email protected]'インストール要件
メールプロバイダのサポートはインストール方法に依存します。
SMTP
✅
✅
✅
SendGrid
❌
❌
✅
AWS SES
❌
❌
✅
Gmail OAuth
❌
❌
✅
Microsoft OAuth
❌
❌
✅
完全なメールサポートでインストール
pip install keepercommander[email]OAuth対話型フロー
--oauth-access-token なしでGmailまたはMicrosoftのOAuth構成を作成する場合 、対話型の認可フローを開始します。
ローカルウェブサーバーがポート8080で起動（
--oauth-portで設定可能)ブラウザがプロバイダの認可ページを開く
ユーザーがログインしてアプリケーションを承認
ブラウザが認可コード付きでlocalhostにリダイレクト
コマンダーがコードをトークンに交換
トークンは暗号化されKeeperボルトに保存
トークン管理
アクセストークンは1時間で期限切れ
コマンダーはリフレッシュトークンを使用して自動的に更新
トークンが期限切れの場合、メール送信前に更新が実行される
更新されたトークンは自動的にボルトに保存
トラブルシューティング
エラー: 「Provider is not available in the binary installation」
バイナリインストールはSMTPのみサポートします。pipインストールに切り替えてます。
pip install keepercommander[email]エラー: 「Missing required dependencies for provider」
メール拡張付きでインストールします。
pip install --upgrade keepercommander[email]エラー: 「Interactive OAuth flow is not available on binary installation」
オプション
pipインストールに切り替える (推奨)
代わりにSMTPプロバイダを使用します。
--oauth-access-token,--oauth-refresh-token,--oauth-token-expiryを使用してOAuthトークンを手動で提供
エラー: 「Port 8080 already in use」
OAuthコールバックに別のポートを使用します。
email-config create ... --oauth-port 9090エラー: 「email-config not found」
構成名が存在しません。利用可能な構成を一覧表示します。
email-config list最終更新