Add User Account To An Ubuntu Server

This is an interactive task for adding a user account to a Ubuntu Server. This task sends an approval request to Slack before the user account is created

Integrations

• PPA User Interface
• Hashicorp Vault Key-Value engine
• SSH Client
• Slack Incoming Webhooks

Required Vault Details

Ubuntu Server

For more information see SSH Server Running Commands

• IP/DNS address of a Ubuntu Server
• Port
• Base Prompt
• Username
• Password

Slack

For more information see Slack Integration

• Webhook URL

As this is a privileged task, the credentials used for the Ubuntu Server must be part of the sudoers group.

Vault Configuration Wizard

The first time you run a task built from this playbook, PPA will check the required Vault details exist.

If they don't exist, PPA will ask you to supply the details at the start of the task.

Below you can see a user providing details the first time they run an Active Directory task.

Once the details are added to Vault, the task won't ask for them again.

If you don't know the required details, ask an administrator to run the task or configure Vault manually.

What the Task Does

Once started, this task allows the operator to:

• Enter a username for the user account
• Choose temporary password
• Request approval via Slack

Task Failure Messages (optional)

This task can supply a message to the Activity page if the task fails.

To test this do the following in PPA after you've built & tested the task:

• Navigate to the Playbook Editor
• Click the burger menu for your Playbook
• Select Edit Metadata
• Expand the Advanced section
• Paste the JSON below into the Exit Codes section
• Click Save

{
  "2": "Approval request was rejected.",
  "3": "Failed to create user account. Please view the logs for more information."
}