Chapter 3. Hammer authentication

Procedure

• Add your credentials to the ~/.hammer/cli.modules.d/foreman.yml configuration file:

  :foreman:
   :username: 'username'
   :password: 'password'

  Use only spaces for indentation in Hammer configuration files, do not use tabs.

Procedure

• Specify your credentials when executing a command as follows:

  $ hammer -u username -p password subcommands

Prerequisites

• You have enabled sessions by adding :use_sessions: true to the ~/.hammer/cli.modules.d/foreman.yml file:

  :foreman:
   :use_sessions: true

  Note that if you enable sessions, credentials stored in the configuration file will be ignored.

• Optional: You can change the length of a session, for example, to 30 minutes:

  $ hammer settings set \
  --name idle_timeout \
  --value 30

  The default length is 60 minutes.

Procedure

• Start a session:

  $ hammer auth login

  You are prompted for your Satellite credentials, and logged in. You will not be prompted for the credentials again until your session expires.

Verification

• View the current status of the session:

  $ hammer auth status

Next steps

• End the session:

  $ hammer auth logout