1.2. 認証
hammer コマンドを使用する場合は Red Hat Satellite に識別子を証明する必要があります。hammer コマンドは手動または自動で実行できます。いずれの場合も、認証には Satellite 認証情報が必要です。hammer 認証には 3 つの方法があります。
- hammer 認証セッション
- hammer 設定ファイルに認証情報を保存
- hammer コマンドを使用するたびに認証情報を指定
自動でコマンドを実行する場合は、hammer 設定ファイルを使用することが推奨されます。たとえば、cron ジョブから Satellite メンテナンスコマンドを実行する場合です。コマンドを手動で実行する場合、Red Hat は、hammer 認証セッションを使用して、コマンドを実行するたびに認証情報を提供する方法を推奨します。
1.2.1. hammer 認証セッション リンクのコピーリンクがクリップボードにコピーされました!
hammer 認証セッションでは、認証情報をキャッシュで保存するため、セッションの最初に一度だけ認証情報を入力する必要があります。この方法は、複数の hammer コマンドを含むスクリプトなど、複数の hammer コマンドを順次実行する場合に適しています。このようなシナリオでは Satellite の認証情報を一度入力すると、スクリプトは想定通りに実行します。hammer 認証セッションを使用する場合は、スクリプト自体に認証情報を保存せず、hammer 設定ファイル ~/.hammer/cli.modules.d/foreman.yml
に保存します。
セッションの使用方法は以下のようになります。
セッションを有効にするには、
:use_sessions: true
を~/.hammer/cli.modules.d/foreman.yml
ファイルに追加します。:foreman: :use_sessions: true
:foreman: :use_sessions: true
Copy to Clipboard Copied! Toggle word wrap Toggle overflow セッションを有効にすると、設定ファイルに保存している認証情報は無視されます。
セッションを開始するには、以下のコマンドを入力します。
hammer auth login
# hammer auth login
Copy to Clipboard Copied! Toggle word wrap Toggle overflow Satellite 認証情報が求められ、ログインします。その認証情報は、セッションの有効期限が切れるまで持続するため、再要求はされません。
セッションのデフォルトの長さは 60 分です。必要に応じて時間を変更できます。たとえば、これを 30 分に変更するには、以下のコマンドを実行します。
hammer settings set --name idle_timeout --value 30
# hammer settings set --name idle_timeout --value 30 Setting [idle_timeout] updated to [30]
Copy to Clipboard Copied! Toggle word wrap Toggle overflow セッションの現在のステータスを表示するには、以下のコマンドを実行します。
hammer auth status
# hammer auth status
Copy to Clipboard Copied! Toggle word wrap Toggle overflow セッションを終了するには、以下のコマンドを入力します。
hammer auth logout
# hammer auth logout
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
1.2.2. hammer 設定ファイル リンクのコピーリンクがクリップボードにコピーされました!
--foreman-initial-admin-username
オプションおよび --foreman-initial-admin-password
オプションを使用して Satellite のインストールを実行すると、入力した認証情報が ~/.hammer/cli.modules.d/foreman.yml
に保存され、hammer により認証情報の入力が求められます。
認証情報は、手動で ~/.hammer/cli.modules.d/foreman.yml
設定ファイルに追加することもできます。
:foreman: :username: 'username' :password: 'password'
:foreman:
:username: 'username'
:password: 'password'
hammer 設定ファイルのインデントには、スペースのみを使用するようにしてください。タブは使用しないでください。
1.2.3. コマンドライン リンクのコピーリンクがクリップボードにコピーされました!
Satellite 認証情報を ~/.hammer/cli.modules.d/foreman.yml
設定ファイルに保存しないと、コマンドを入力するたびに hammer によって認証情報が求められます。以下のように、コマンドの実行時に認証情報を指定できます。
hammer -u username -p password subcommands
$ hammer -u username -p password subcommands
このガイドの例は、設定ファイルの認証情報が保存されているか、hammer 認証セッションを使用していることを前提としています。