ktdreyer.koji_ansible.koji_user (0.0.450) — module

Install collection

Install with ansible-galaxy collection install ktdreyer.koji_ansible:==0.0.450

Add to requirements.yml

  collections:
    - name: ktdreyer.koji_ansible
      version: 0.0.450

Description

This module can add new users and manage existing users.

Koji only supports adding new users, not deleting them. Once they are defined, you can enable or disable the users with "state: enabled" or "state: disabled".

The "LoginCreatesUser" setting on the Koji Hub permits users to create their own accounts on first login, provided they have a valid credential (SSL cert or Kerberos ticket). LoginCreatesUser defaults to "On". If you disabled LoginCreatesUser on your hub, you may use this koji_user module to create your Koji user accounts. Even if your hub has LoginCreatesUser enabled, you may still use this module to pre-create accounts without asking users to login first (eg. to configure package ownership), or to manage permissions for accounts.

Requirements

• python >= 2.7
• koji

Usage examples

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: create a koji user
  hosts: localhost
  tasks:
    - name: Add new kdreyer user
      koji_user:
        name: kdreyer
        state: enabled
        permissions: [admin]

Inputs

    
name:
    description:
    - The name of the Koji user.
    - 'Example: "kdreyer".'
    required: true

state:
    description:
    - Whether to set this user as "enabled" or "disabled". If unset, this defaults to
      "enabled".

permissions:
    description:
    - A list of permissions for this user. If unset, Ansible will not edit the permissions
      for this user. To remove all permissions, set this to an empty list.
    - 'Example: [admin]'

krb_principal:
    description:
    - Set a single non-default krb principal for this user. If unset, Koji will use the
      standard krb principal scheme for user accounts.
    - Mutually exclusive with I(krb_principals).

krb_principals:
    description:
    - Set a list of non-default krb principals for this user. If unset, Koji will use
      the standard krb principal scheme for user accounts. Your Koji Hub must be v1.19
      or later to use this option.
    - Mutually exclusive with I(krb_principal).