Better handling of public SSH keys using Ansible..

Posted by – 08/03/2014

Ansible has a dedicated module to manage public keys; the authorized_key module. It’s a very nice module, with enough flexibility to do almost anything I can think of.

However, it does have one very annoying thing. While I was migrating our automation scripts to ansible; I got to the point where I was working on the script that provisions our users. By default, we disabled all password authentication and root SSH access. Only key based access is allowed.

I found that I have to actually put the public SSH key strings inside the playbook vars. That’s just not cool. SSH keys are long, they might have specific options (although the authorized_key module allows you to configure that) and it’s harder to maintain the list of keys like this. So, I tried to work around this. My target was to add the public SSH keys for my users as static files in an ansible role. Basically, I will be populating my my group_vars files by reading files inside my roles.

  • First, I added the public key files in the ‘files‘ directory of the role I was using to configure the users.
  • Now, I have to find a way to “read” the key files and set them in the vars file. Fortunately, ansible provides Lookup plugins that allows me to do just that!
  • So, the related part of the vars file should look like this:
  - name: user1
    key: "{{ lookup('file', '') }}"
  - name: user2
    key: "{{ lookup('file', '') }}"
  - name: user3
    key: "{{ lookup('file', '') }}"
  - name: user4
    key: "{{ lookup('file', '') }}"
  • Next, all we need to do is call the authorized_key module as usual
- name: Add ssh user keys
  authorized_key: user={{ }} key="{{ item.key }}"
  with_items: ssh_users

Edit: Updated the variable name to avoid the deprecated syntax. Details in the first comment.

Here you go. Key files are neatly tucked in the files directory, easy to maintain and no wrapped lines and cluttered options missing up your var files.

15 Comments on Better handling of public SSH keys using Ansible..

  1. Quick public service announcement note that “${foo} and $foo” are legacy variable syntax, so you can just say “with_items: ssh_users”. On the development branch (1.6) these deprecated constructs are finally removed. That is all :)

    • broken says:

      Thanks, Michael, for the update! I will make sure to update my playbooks and the post to avoid this. We don’t want those to break when we upgrade :)

      Great job done on Ansible, I love it :)

  2. Gerhard Lazu says:

    authorized_key has a with_file option which seems to achieve the same result:

    - name: SSH key
    authorized_key: user=gerhard key="{{ item }}"

    • broken says:

      Yes, it does have the with_files. However, it helps only when you are adding multiple public keys for the same user.

      I am trying to add multiple users, with a key per user. I couldn’t do that with with_files alone.

      • Nate Friedman says:

        I was able to take the above guide, and combine it with the with_fileglob and file lookup to fill a couple folders with allowed, and denied pubkeys:

        – name: Manage Authorized Keys – Allow
        authorized_key: user=targetUser key=”{{ lookup(‘file’, item) }}” state=present
        with_fileglob: pubkeys/allow/*
        – name: Manage Authorized Keys – Deny
        authorized_key: user= targetUser key=”{{ lookup(‘file’, item) }}” state=absent
        with_fileglob: pubkeys/deny/*

  3. Martin Bishop says:

    Thanks for this, a great example of how slick ansible is compared to puppet – IMHO, and this example fits my needs perfectly.

    In this line – user={{ }} key=”{{ item.key }}”
    Why is it that you need double quotes for item.key but not

    • broken says:

      That’s actually a good question! I put the double quotes because that’s how it is in the documentation. Here is the example from the documentation:

      # Using with_file
      - name: Set up authorized_keys for the deploy user
      authorized_key: user=deploy
      key="{{ item }}"
      - public_keys/doe-jane
      - public_keys/doe-john

      • Allen Austin says:

        It needs to be quoted because those variables potentially could have an equal sign in their contents (ssh keys usually do) which Ansible could then treat as a variable assignment. By quoting them you tell Anslible to treat these variables as string literals. To do otherwise potentially opens up a vector for data execution. The latest versions of Ansible try to detect for this condition and warn on it.

  4. Luis Muñiz says:

    I’ve been struggling (and almost gave up) on how to achieve those same results: many users, each with a local key file.

    As a side notice, you can also specify multiple keys per user by separating keys with a newline:

    - name: user1
    key: "{{ lookup('file', '') }}
    {{ lookup('file', '') }}"
    - name: user2
    key: "{{ lookup('file', '') }}"

    • Luis Muñiz says:

      Uh oh, and, btw, many many thanks for your solution! ;-)

    • Luis Muñiz says:

      Arrgggh! You need to add (at least) an extra newline between keys:

      – name: user1
      key: “{{ lookup(‘file’, ‘’) }}

      {{ lookup(‘file’, ‘’) }}”
      – name: user2
      key: “{{ lookup(‘file’, ‘’) }}”

  5. […] ended up finding this post which shows a better way of moving the pubkeys out of the actual variables file. Basically you add […]

  6. Dheeraj says:

    I wrote a simple task to test ssh module

    – name: Add ssh user keys
    user: dheeraj
    key: “{{ lookup(‘file’, ‘’) }}”

    when I run the playbook I get the following error

    fatal: []: FAILED! => {“changed”: false, “failed”: true, “msg”: “Failed to lookup user dheeru: ‘getpwnam(): name not found: dheeru'”}

    What would be the issue?

    • Dheeraj says:

      Sorry the error was
      “msg”: “Failed to lookup user dheeru: ‘getpwnam(): name not found: dheeraj’

  7. John says:

    Just a note for other newbs like me. It is probably related to my version of ansible ( I had to modify the with_items as follows; otherwise it bombs out saying that I have undefined variables:

    from this:
    with_items: ssh_users

    to this:
    with_items: “{{ ssh_users }}”

Leave a Reply

Your email address will not be published.