Open source Puppet documentation

NOTE: This page was generated from the Puppet source code on 2018-08-28 06:48:02 -0700

sshkey

Description

Installs and manages ssh host keys. By default, this type will install keys into /etc/ssh/ssh_known_hosts. To manage ssh keys in a different known_hosts file, such as a user’s personal known_hosts, pass its path to the target parameter. See the ssh_authorized_key type to manage authorized keys.

Attributes

sshkey { 'resource title':
  name         => # (namevar) The host name that the key is associated...
  ensure       => # The basic property that the resource should be...
  host_aliases => # Any aliases the host might have.  Multiple...
  key          => # The key itself; generally a long string of...
  provider     => # The specific backend to use for this `sshkey...
  target       => # The file in which to store the ssh key.  Only...
  type         => # The encryption type used.  Probably ssh-dss or...
  # ...plus any applicable metaparameters.
}

name

(Namevar: If omitted, this attribute’s value defaults to the resource’s title.)

The host name that the key is associated with.

(↑ Back to sshkey attributes)

ensure

(Property: This attribute represents concrete state on the target system.)

The basic property that the resource should be in.

Default: present

Allowed values:

  • present
  • absent

(↑ Back to sshkey attributes)

host_aliases

(Property: This attribute represents concrete state on the target system.)

Any aliases the host might have. Multiple values must be specified as an array.

(↑ Back to sshkey attributes)

key

(Property: This attribute represents concrete state on the target system.)

The key itself; generally a long string of uuencoded characters. The key attribute may not contain whitespace.

Make sure to omit the following in this attribute (and specify them in other attributes):

  • Key headers, such as ‘ssh-rsa’ — put these in the type attribute.
  • Key identifiers / comments, such as ‘joescomputer.local’ — put these in the name attribute/resource title.

(↑ Back to sshkey attributes)

provider

The specific backend to use for this sshkey resource. You will seldom need to specify this — Puppet will usually discover the appropriate provider for your platform.

Available providers are:

(↑ Back to sshkey attributes)

target

(Property: This attribute represents concrete state on the target system.)

The file in which to store the ssh key. Only used by the parsed provider.

(↑ Back to sshkey attributes)

type

(Property: This attribute represents concrete state on the target system.)

The encryption type used. Probably ssh-dss or ssh-rsa.

Allowed values:

  • ssh-dss
  • ssh-ed25519
  • ssh-rsa
  • ecdsa-sha2-nistp256
  • ecdsa-sha2-nistp384
  • ecdsa-sha2-nistp521
  • dsa
  • ed25519
  • rsa

(↑ Back to sshkey attributes)

Providers

parsed

Parse and generate host-wide known hosts files for SSH.

NOTE: This page was generated from the Puppet source code on 2018-08-28 06:48:02 -0700

Back to top