{"id":27958130,"url":"https://github.com/ericsson/puppet-module-vas_local_user","last_synced_at":"2025-05-07T18:16:31.466Z","repository":{"id":73272899,"uuid":"47405205","full_name":"Ericsson/puppet-module-vas_local_user","owner":"Ericsson","description":"Manage users locally on systems with QAS","archived":false,"fork":false,"pushed_at":"2019-10-24T11:20:06.000Z","size":34,"stargazers_count":0,"open_issues_count":0,"forks_count":4,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-05-07T18:16:25.991Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Ericsson.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2015-12-04T13:19:05.000Z","updated_at":"2024-03-25T13:21:33.000Z","dependencies_parsed_at":null,"dependency_job_id":"6100b3c7-2578-4f6d-aa36-149e8d80ccc1","html_url":"https://github.com/Ericsson/puppet-module-vas_local_user","commit_stats":null,"previous_names":["ericsson/puppet-module-vas_local_user"],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ericsson%2Fpuppet-module-vas_local_user","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ericsson%2Fpuppet-module-vas_local_user/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ericsson%2Fpuppet-module-vas_local_user/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ericsson%2Fpuppet-module-vas_local_user/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Ericsson","download_url":"https://codeload.github.com/Ericsson/puppet-module-vas_local_user/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252931508,"owners_count":21827112,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-05-07T18:16:29.715Z","updated_at":"2025-05-07T18:16:30.836Z","avatar_url":"https://github.com/Ericsson.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# vas_local_user\n\n[![Build Status](https://api.travis-ci.org/gillarkod/puppet-module-vas_local_user.png)](https://travis-ci.org/gillarkod/puppet-module-vas_local_user)\n\n#### Table of Contents\n\n1. [Overview](#overview)\n2. [Module Description - What the module does and why it is useful](#module-description)\n3. [Setup - The basics of getting started with vas_local_user](#setup)\n    * [What vas_local_user affects](#what-vas_local_user-affects)\n    * [Setup requirements](#setup-requirements)\n    * [Beginning with vas_local_user](#beginning-with-vas_local_user)\n4. [Usage - Configuration options and additional functionality](#usage)\n5. [Reference - An under-the-hood peek at what the module is doing and how](#reference)\n5. [Limitations - OS compatibility, etc.](#limitations)\n6. [Development - Guide for contributing to the module](#development)\n\n## Overview\n\nThis module allows you to manage both users and ssh_authorized_keys on systems\nusing QAS/VAS. The thought behind it is make it easier for you to create users\non systems with and without QAS installed.\n\n## Module Description\n\nThis module manages one or more local users and ssh_authorized_keys (if configured).\nIf it's a newly provisioned system it will create the user or users before installing\nQAS. If QAS is already installed on the system it will only manage the user\nand its ssh_authorized_keys if libuser is supported. The user will be managed on\nsystems without QAS too.\n\n## Setup\n\n### What vas_local_user affects\n\n* It affects the users and ssh_authorized_keys it's configured to manage.\n\n### Beginning with vas_local_user\n\nIf the module is included in the catalogue but not configured in any way it\ndoes not do anything. It takes in total four different parameters.\n\nThe following defaults are used when creating a user.\n\nNot using QAS:\n  'manage_home' =\u003e true\n  'forcelocal'  =\u003e true\n\nUsing QAS (settings above and...):\n  'before'      =\u003e Class['vas']\n\n## Usage\n\n### manage_package\n\nBoolean to control if this module should manage libuser package or not.\n\n- *Default*: USE_DEFAULTS (based on OS)\n\nmanage_package is true on RedHat, CentOS, Debian, Ubuntu and OpenSuSE.\n\nThere doesn't appear the libuser package is available on SLE[DS].\n\n### package_name\n\nString to control the package name managed by parameter 'manage_package'.\n\n- *Default*: libuser\n\n\n### manage_users\n\nBoolean to control if this module should manage users or not.\n\n- *Default*: true\n\n### users\n\nA hash of all users the module should manage/create.\n\n- *Default*: undef\n\n### ssh_keys\n\nA hash of all ssh_authorized_keys the module should manage/create.\n\n- *Default*: undef\n\n### users_hiera_merge\n\nSet to true to enable hiera_merge for parameter 'users'.\n\n- *Default*: false\n\n### groups_hiera_merge\n\nSet to true to enable hiera_merge for parameter 'groups'.\n\n- *Default*: false\n\n## Reference\n\nClasses:\n\n* vas_local_user\n\n## Limitations\n\nThis module uses before on Class['vas'] to guess whether QAS is in the catalogue\nor not. This module has been tested in combination with Ericsson/puppet-module-vas.\n\nRequires Puppet \u003e=3.2 since it uses User type's parameter forcelocal.\n\n## Development\n\nPlease make changes atomic. Rebase your commits if neccessary to make it atomic.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fericsson%2Fpuppet-module-vas_local_user","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fericsson%2Fpuppet-module-vas_local_user","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fericsson%2Fpuppet-module-vas_local_user/lists"}