{"id":40951435,"url":"https://github.com/salesforcecli/plugin-user","last_synced_at":"2026-04-05T08:01:12.635Z","repository":{"id":37967161,"uuid":"308448844","full_name":"salesforcecli/plugin-user","owner":"salesforcecli","description":null,"archived":false,"fork":false,"pushed_at":"2026-03-27T18:41:58.000Z","size":10757,"stargazers_count":4,"open_issues_count":0,"forks_count":3,"subscribers_count":5,"default_branch":"main","last_synced_at":"2026-03-28T02:23:34.799Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":false,"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/salesforcecli.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2020-10-29T21:01:06.000Z","updated_at":"2026-03-27T18:42:02.000Z","dependencies_parsed_at":"2026-02-08T08:04:26.843Z","dependency_job_id":null,"html_url":"https://github.com/salesforcecli/plugin-user","commit_stats":{"total_commits":1205,"total_committers":29,"mean_commits":41.55172413793103,"dds":"0.46887966804979253","last_synced_commit":"94c7ed6e436a8781f150f30c548e257c5e824e8a"},"previous_names":[],"tags_count":248,"template":false,"template_full_name":"salesforcecli/plugin-template","purl":"pkg:github/salesforcecli/plugin-user","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/salesforcecli%2Fplugin-user","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/salesforcecli%2Fplugin-user/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/salesforcecli%2Fplugin-user/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/salesforcecli%2Fplugin-user/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/salesforcecli","download_url":"https://codeload.github.com/salesforcecli/plugin-user/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/salesforcecli%2Fplugin-user/sbom","scorecard":{"id":796399,"data":{"date":"2025-08-11","repo":{"name":"github.com/salesforcecli/plugin-user","commit":"9ecf17b726aae4719c6a108cf84498b40e475cdc"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":5,"checks":[{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Code-Review","score":0,"reason":"Found 0/4 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Security-Policy","score":9,"reason":"security policy file detected","details":["Info: security policy file detected: SECURITY.md:1","Info: Found linked content: SECURITY.md:1","Warn: One or no descriptive hints of disclosure, vulnerability, and/or timelines in security policy","Info: Found text in security policy: SECURITY.md:1"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Maintained","score":10,"reason":"30 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 10","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: third-party GitHubAction not pinned by hash: .github/workflows/automerge.yml:9: update your workflow using https://app.stepsecurity.io/secureworkflow/salesforcecli/plugin-user/automerge.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/create-github-release.yml:18: update your workflow using https://app.stepsecurity.io/secureworkflow/salesforcecli/plugin-user/create-github-release.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/devScripts.yml:9: update your workflow using https://app.stepsecurity.io/secureworkflow/salesforcecli/plugin-user/devScripts.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/failureNotifications.yml:16: update your workflow using https://app.stepsecurity.io/secureworkflow/salesforcecli/plugin-user/failureNotifications.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/notify-slack-on-pr-open.yml:23: update your workflow using https://app.stepsecurity.io/secureworkflow/salesforcecli/plugin-user/notify-slack-on-pr-open.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/onRelease.yml:25: update your workflow using https://app.stepsecurity.io/secureworkflow/salesforcecli/plugin-user/onRelease.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/onRelease.yml:19: update your workflow using https://app.stepsecurity.io/secureworkflow/salesforcecli/plugin-user/onRelease.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/onRelease.yml:22: update your workflow using https://app.stepsecurity.io/secureworkflow/salesforcecli/plugin-user/onRelease.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/test.yml:19: update your workflow using https://app.stepsecurity.io/secureworkflow/salesforcecli/plugin-user/test.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/test.yml:9: update your workflow using https://app.stepsecurity.io/secureworkflow/salesforcecli/plugin-user/test.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/test.yml:13: update your workflow using https://app.stepsecurity.io/secureworkflow/salesforcecli/plugin-user/test.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/test.yml:16: update your workflow using https://app.stepsecurity.io/secureworkflow/salesforcecli/plugin-user/test.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/validate-pr.yml:11: update your workflow using https://app.stepsecurity.io/secureworkflow/salesforcecli/plugin-user/validate-pr.yml/main?enable=pin","Info:   0 out of   1 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of  12 third-party GitHubAction dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: no topLevel permission defined: .github/workflows/automerge.yml:1","Warn: no topLevel permission defined: .github/workflows/create-github-release.yml:1","Warn: no topLevel permission defined: .github/workflows/devScripts.yml:1","Warn: no topLevel permission defined: .github/workflows/failureNotifications.yml:1","Warn: no topLevel permission defined: .github/workflows/notify-slack-on-pr-open.yml:1","Warn: no topLevel permission defined: .github/workflows/onRelease.yml:1","Warn: no topLevel permission defined: .github/workflows/test.yml:1","Warn: no topLevel permission defined: .github/workflows/validate-pr.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE.txt:0","Info: FSF or OSI recognized license: Apache License 2.0: LICENSE.txt:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":-1,"reason":"internal error: error during branchesHandler.setup: internal error: githubv4.Query: Resource not accessible by integration","details":null,"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 26 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Vulnerabilities","score":6,"reason":"4 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: GHSA-968p-4wvh-cqc8","Warn: Project is vulnerable to: GHSA-v6h2-p8h4-qcjw","Warn: Project is vulnerable to: GHSA-9wv6-86v2-598j","Warn: Project is vulnerable to: GHSA-c2qf-rxjj-qqgw"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-23T09:08:20.156Z","repository_id":37967161,"created_at":"2025-08-23T09:08:20.156Z","updated_at":"2025-08-23T09:08:20.156Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31428645,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-05T02:22:46.605Z","status":"ssl_error","status_checked_at":"2026-04-05T02:22:33.263Z","response_time":75,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":"2026-01-22T05:13:16.683Z","updated_at":"2026-04-05T08:01:12.574Z","avatar_url":"https://github.com/salesforcecli.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# plugin-user\n\n[![NPM](https://img.shields.io/npm/v/@salesforce/plugin-user.svg?label=@salesforce/plugin-user)](https://www.npmjs.com/package/@salesforce/plugin-user) [![Downloads/week](https://img.shields.io/npm/dw/@salesforce/plugin-user.svg)](https://npmjs.org/package/@salesforce/plugin-user) [![License](https://img.shields.io/badge/License-Apache--2.0-blue.svg)](https://opensource.org/license/apache-2-0)\n\nCommands to interact with Users and Permission Sets in a scratch org\n\nThis plugin is bundled with the [Salesforce CLI](https://developer.salesforce.com/tools/sfdxcli). For more information on the CLI, read the [getting started guide](https://developer.salesforce.com/docs/atlas.en-us.sfdx_setup.meta/sfdx_setup/sfdx_setup_intro.htm).\n\nWe always recommend using the latest version of these commands bundled with the CLI, however, you can install a specific version or tag if needed.\n\n## Install\n\n```bash\nsfdx plugins:install user@x.y.z\n```\n\n## Issues\n\nPlease report any issues at https://github.com/forcedotcom/cli/issues\n\n## Contributing\n\n1. Please read our [Code of Conduct](CODE_OF_CONDUCT.md)\n2. Create a new issue before starting your project so that we can keep track of\n   what you are trying to add/fix. That way, we can also offer suggestions or\n   let you know if there is already an effort in progress.\n3. Fork this repository.\n4. [Build the plugin locally](#build)\n5. Create a _topic_ branch in your fork. Note, this step is recommended but technically not required if contributing using a fork.\n6. Edit the code in your fork.\n7. Write appropriate tests for your changes. Try to achieve at least 95% code coverage on any new code. No pull request will be accepted without unit tests.\n8. Sign CLA (see [CLA](#cla) below).\n9. Send us a pull request when you are done. We'll review your code, suggest any needed changes, and merge it in.\n\n### CLA\n\nExternal contributors will be required to sign a Contributor's License\nAgreement. You can do so by going to https://cla.salesforce.com/sign-cla.\n\n### Build\n\nTo build the plugin locally, make sure to have yarn installed and run the following commands:\n\n```bash\n# Clone the repository\ngit clone git@github.com:salesforcecli/plugin-user\n\n# Install the dependencies and compile\nyarn install\nyarn build\n```\n\nTo use your plugin, run using the local `./bin/dev` or `./bin/dev.cmd` file.\n\n```bash\n# Run using local run file.\n./bin/dev user\n```\n\nThere should be no differences when running via the Salesforce CLI or using the local run file. However, it can be useful to link the plugin to do some additional testing or run your commands from anywhere on your machine.\n\n```bash\n# Link your plugin to the sfdx cli\nsfdx plugins:link .\n# To verify\nsfdx plugins\n```\n\n### Test\n\nRun unit tests (orgs and filesystem are mocked)\n\n```bash\nyarn test\n```\n\nRun not-unit-tests (real orgs, real FS)\n\n```bash\n# use your locally authenticated dev hub.  Supports both JWT and Refresh Token (web) auth\nexport TESTKIT_HUB_USERNAME=\u003cusername for dev hub\u003e\nyarn test:nuts\n```\n\nFor more NUT options and examples, see \u003chttps://github.com/salesforcecli/cli-plugins-testkit\u003e\n\n## Commands\n\n\u003c!-- commands --\u003e\n\n- [`sf org assign permset`](#sf-org-assign-permset)\n- [`sf org assign permsetlicense`](#sf-org-assign-permsetlicense)\n- [`sf org create user`](#sf-org-create-user)\n- [`sf org display user`](#sf-org-display-user)\n- [`sf org generate password`](#sf-org-generate-password)\n- [`sf org list users`](#sf-org-list-users)\n\n## `sf org assign permset`\n\nAssign a permission set to one or more org users.\n\n```\nUSAGE\n  $ sf org assign permset -n \u003cvalue\u003e... -o \u003cvalue\u003e [--json] [--flags-dir \u003cvalue\u003e] [-b \u003cvalue\u003e...] [--api-version\n  \u003cvalue\u003e]\n\nFLAGS\n  -b, --on-behalf-of=\u003cvalue\u003e...  Username or alias to assign the permission set to.\n  -n, --name=\u003cvalue\u003e...          (required) Permission set to assign.\n  -o, --target-org=\u003cvalue\u003e       (required) Username or alias of the target org. Not required if the `target-org`\n                                 configuration variable is already set.\n      --api-version=\u003cvalue\u003e      Override the api version used for api requests made by this command\n\nGLOBAL FLAGS\n  --flags-dir=\u003cvalue\u003e  Import flag values from a directory.\n  --json               Format output as json.\n\nDESCRIPTION\n  Assign a permission set to one or more org users.\n\n  To specify an alias for the --target-org or --on-behalf-of flags, use the CLI username alias, such as the one you set\n  with the \"alias set\" command. Don't use the value of the Alias field of the User Salesforce object for the org user.\n\n  To assign multiple permission sets, either set multiple --name flags or a single --name flag with multiple names\n  separated by spaces. Enclose names that contain spaces in one set of double quotes. The same syntax applies to\n  --on-behalf-of.\n\nEXAMPLES\n  Assign two permission sets called DreamHouse and CloudHouse to original admin user of your default org:\n\n    $ sf org assign permset --name DreamHouse --name CloudHouse\n\n  Assign the Dreamhouse permission set to the original admin user of the org with alias \"my-scratch\":\n\n    $ sf org assign permset --name DreamHouse --target-org my-scratch\n\n  Assign the Dreamhouse permission set to the specified list of users of your default org:\n\n    $ sf org assign permset --name DreamHouse --on-behalf-of user1@my.org --on-behalf-of user2 --on-behalf-of user\n```\n\n_See code: [src/commands/org/assign/permset.ts](https://github.com/salesforcecli/plugin-user/blob/3.8.3/src/commands/org/assign/permset.ts)_\n\n## `sf org assign permsetlicense`\n\nAssign a permission set license to one or more org users.\n\n```\nUSAGE\n  $ sf org assign permsetlicense -n \u003cvalue\u003e... -o \u003cvalue\u003e [--json] [--flags-dir \u003cvalue\u003e] [-b \u003cvalue\u003e...] [--api-version\n  \u003cvalue\u003e]\n\nFLAGS\n  -b, --on-behalf-of=\u003cvalue\u003e...  Usernames or alias to assign the permission set license to.\n  -n, --name=\u003cvalue\u003e...          (required) Name of the permission set license to assign.\n  -o, --target-org=\u003cvalue\u003e       (required) Username or alias of the target org. Not required if the `target-org`\n                                 configuration variable is already set.\n      --api-version=\u003cvalue\u003e      Override the api version used for api requests made by this command\n\nGLOBAL FLAGS\n  --flags-dir=\u003cvalue\u003e  Import flag values from a directory.\n  --json               Format output as json.\n\nDESCRIPTION\n  Assign a permission set license to one or more org users.\n\n  To specify an alias for the --target-org or --on-behalf-of flags, use the CLI username alias, such as the one you set\n  with the \"alias set\" command. Don't use the value of the Alias field of the User Salesforce object for the org user.\n\n  To assign multiple permission sets, either set multiple --name flags or a single --name flag with multiple names\n  separated by spaces. Enclose names that contain spaces in one set of double quotes. The same syntax applies to\n  --on-behalf-of.\n\nEXAMPLES\n  Assign the DreamHouse permission set license to original admin user of your default org:\n\n    $ sf org assign permsetlicense --name DreamHouse\n\n  Assign two permission set licenses to the original admin user of the org with alias \"my-scratch\":\n\n    $ sf org assign permsetlicense --name DreamHouse --name CloudHouse --target-org my-scratch\n\n  Assign the Dreamhouse permission set license to the specified list of users of your default org:\n\n    $ sf org assign permsetlicense --name DreamHouse --on-behalf-of user1@my.org --on-behalf-of user2 --on-behalf-of \\\n      user3\n```\n\n_See code: [src/commands/org/assign/permsetlicense.ts](https://github.com/salesforcecli/plugin-user/blob/3.8.3/src/commands/org/assign/permsetlicense.ts)_\n\n## `sf org create user`\n\nCreate a user for a scratch org.\n\n```\nUSAGE\n  $ sf org create user -o \u003cvalue\u003e [--json] [--flags-dir \u003cvalue\u003e] [-a \u003cvalue\u003e] [-f \u003cvalue\u003e] [-s] [--api-version\n    \u003cvalue\u003e]\n\nFLAGS\n  -a, --set-alias=\u003cvalue\u003e        Set an alias for the created username to reference in other CLI commands.\n  -f, --definition-file=\u003cvalue\u003e  File path to a user definition file for customizing the new user.\n  -o, --target-org=\u003cvalue\u003e       (required) Username or alias of the target org. Not required if the `target-org`\n                                 configuration variable is already set.\n  -s, --set-unique-username      Force the username, if specified in the definition file or at the command line, to be\n                                 unique by appending the org ID.\n      --api-version=\u003cvalue\u003e      Override the api version used for api requests made by this command\n\nGLOBAL FLAGS\n  --flags-dir=\u003cvalue\u003e  Import flag values from a directory.\n  --json               Format output as json.\n\nDESCRIPTION\n  Create a user for a scratch org.\n\n  A scratch org includes one administrator user by default. For testing purposes, however, you sometimes need to create\n  additional users.\n\n  The easiest way to create a user is to let this command assign default or generated characteristics to the new user.\n  If you want to customize your new user, create a definition file and specify it with the --definition-file flag. In\n  the file, you can include all the User sObject (Salesforce object) fields and Salesforce DX-specific options, as\n  described in \"User Definition File for Customizing a Scratch Org User\"\n  (https://developer.salesforce.com/docs/atlas.en-us.sfdx_dev.meta/sfdx_dev/sfdx_dev_scratch_orgs_users_def_file.htm).\n  You can also specify these options on the command line.\n\n  If you don't customize your new user, this command creates a user with the following default characteristics:\n\n  * The username is the existing administrator’s username prepended with a timestamp, such as\n  1505759162830_test-wvkpnfm5z113@example.com.\n  * The user’s profile is Standard User.\n  * The values of the required fields of the User sObject are the corresponding values of the administrator user.\n  * The user has no password.\n\n  Use the --set-alias flag to assign a simple name to the user that you can reference in later CLI commands. This alias\n  is local and different from the Alias field of the User sObject record of the new user, which you set in the Setup UI.\n\n  When this command completes, it displays the new username and user ID. Run the \"org display user\" command to get more\n  information about the new user.\n\n  After the new user has been created, Salesforce CLI automatically authenticates it to the scratch org so the new user\n  can immediately start using the scratch org. The CLI uses the same authentication method that was used on the\n  associated Dev Hub org. Due to Hyperforce limitations, the scratch org user creation fails if the Dev Hub\n  authentication used the JWT flow and the scratch org is on Hyperforce. For this reason, if you plan to create scratch\n  org users, authenticate to the Dev Hub org with either the \"org login web\" or \"org login sfdx-url\" command, and not\n  \"org login jwt\".\n\n  For more information about user limits, defaults, and other considerations when creating a new scratch org user, see\n  https://developer.salesforce.com/docs/atlas.en-us.sfdx_dev.meta/sfdx_dev/sfdx_dev_scratch_orgs_users.htm.\n\nALIASES\n  $ sf force user create\n\nEXAMPLES\n  Create a user for your default scratch org and let this command generate a username, user ID, and other\n  characteristics:\n\n    $ sf org create user\n\n  Create a user with alias \"testuser1\" using a user definition file. Set the \"profileName\" option to \"Chatter Free\n  User\", which overrides the value in the defintion file if it also exists there. Create the user for the scratch org\n  with alias \"my-scratch\":\n\n    $ sf org create user --set-alias testuser1 --definition-file config/project-user-def.json profileName='Chatter \\\n      Free User' --target-org my-scratch\n\n  Create a user by specifying the username, email, and perm set assignment at the command line; command fails if the\n  username already exists in Salesforce:\n\n    $ sf org create user username=testuser1@my.org email=me@my.org permsets=DreamHouse\n\n  Create a user with a definition file, set the email value as specified (overriding any value in the definition\n  file), and generate a password for the user. If the username in the definition file isn't unique, the command\n  appends the org ID to make it unique:\n\n    $ sf org create user --definition-file config/project-user-def.json email=me@my.org generatepassword=true \\\n      --set-unique-username\n\nFLAG DESCRIPTIONS\n  -f, --definition-file=\u003cvalue\u003e  File path to a user definition file for customizing the new user.\n\n    The user definition file uses JSON format and can include any Salesforce User sObject field and Salesforce\n    DX-specific options. See\n    https://developer.salesforce.com/docs/atlas.en-us.sfdx_dev.meta/sfdx_dev/sfdx_dev_scratch_orgs_users_def_file.htm\n    for more information.\n\n  -s, --set-unique-username\n\n    Force the username, if specified in the definition file or at the command line, to be unique by appending the org\n    ID.\n\n    The new user’s username must be unique across all Salesforce orgs and in the form of an email address. If you let\n    this command generate a username for you, it's guaranteed to be unique. If you specify an existing username in a\n    definition file, the command fails. Set this flag to force the username to be unique; as a result, the username\n    might be different than what you specify in the definition file.\n```\n\n_See code: [src/commands/org/create/user.ts](https://github.com/salesforcecli/plugin-user/blob/3.8.3/src/commands/org/create/user.ts)_\n\n## `sf org display user`\n\nDisplay information about a Salesforce user.\n\n```\nUSAGE\n  $ sf org display user -o \u003cvalue\u003e [--json] [--flags-dir \u003cvalue\u003e] [--api-version \u003cvalue\u003e]\n\nFLAGS\n  -o, --target-org=\u003cvalue\u003e   (required) Username or alias of the target org. Not required if the `target-org`\n                             configuration variable is already set.\n      --api-version=\u003cvalue\u003e  Override the api version used for api requests made by this command\n\nGLOBAL FLAGS\n  --flags-dir=\u003cvalue\u003e  Import flag values from a directory.\n  --json               Format output as json.\n\nDESCRIPTION\n  Display information about a Salesforce user.\n\n  Output includes the profile name, org ID, access token, instance URL, login URL, and alias if applicable. The\n  displayed alias is local and different from the Alias field of the User sObject record of the new user, which you set\n  in the Setup UI.\n\nALIASES\n  $ sf force user display\n\nEXAMPLES\n  Display information about the admin user of your default scratch org:\n\n    $ sf org display user\n\n  Display information about the specified user and output in JSON format:\n\n    $ sf org display user --target-org me@my.org --json\n```\n\n_See code: [src/commands/org/display/user.ts](https://github.com/salesforcecli/plugin-user/blob/3.8.3/src/commands/org/display/user.ts)_\n\n## `sf org generate password`\n\nGenerate a random password for scratch org users.\n\n```\nUSAGE\n  $ sf org generate password -o \u003cvalue\u003e [--json] [--flags-dir \u003cvalue\u003e] [-b \u003cvalue\u003e...] [-l \u003cvalue\u003e] [-c \u003cvalue\u003e]\n    [--api-version \u003cvalue\u003e]\n\nFLAGS\n  -b, --on-behalf-of=\u003cvalue\u003e...  Comma-separated list of usernames or aliases to assign the password to; must have been\n                                 created locally with the \"org create user\" command.\n  -c, --complexity=\u003cvalue\u003e       [default: 5] Level of password complexity or strength; the higher the value, the\n                                 stronger the password.\n  -l, --length=\u003cvalue\u003e           [default: 20] Number of characters in the generated password; valid values are between\n                                 20 and 100. Default value is 20.\n  -o, --target-org=\u003cvalue\u003e       (required) Username or alias of the target org. Not required if the `target-org`\n                                 configuration variable is already set.\n      --api-version=\u003cvalue\u003e      Override the api version used for api requests made by this command\n\nGLOBAL FLAGS\n  --flags-dir=\u003cvalue\u003e  Import flag values from a directory.\n  --json               Format output as json.\n\nDESCRIPTION\n  Generate a random password for scratch org users.\n\n  By default, new scratch orgs contain one admin user with no password. Use this command to generate or change a\n  password for this admin user. After it's set, you can’t unset a password, you can only change it.\n\n  You can also use the --on-behalf-of flag to generate a password for a scratch org user that you've created locally\n  with the \"org create user\" command. This command doesn't work for users you created in the scratch org using Setup.\n\n  To change the password strength, set the --complexity flag to a value between 0 and 5. Each value specifies the types\n  of characters used in the generated password:\n\n  0 - lower case letters only\n  1 - lower case letters and numbers only\n  2 - lower case letters and symbols only\n  3 - lower and upper case letters and numbers only\n  4 - lower and upper case letters and symbols only\n  5 - lower and upper case letters and numbers and symbols only\n\n  To see a password that was previously generated, run \"org display user\".\n\nEXAMPLES\n  Generate a password for the original admin user of your default scratch org:\n\n    $ sf org generate password\n\n  Generate a password that contains 25 characters for the original admin user of the scratch org with alias\n  \"my-scratch\":\n\n    $ sf org generate password --length 25 --target-org my-scratch\n\n  Generate a password for your default scratch org admin user that uses lower and upper case letters and numbers only:\n\n    $ sf org generate password --complexity 3\n\n  Generate a password for the specified users in the default scratch org; these users must have been created locally\n  with the \"org create user\" command:\n\n    $ sf org generate password --on-behalf-of user1@my.org --on-behalf-of user2@my.org --on-behalf-of user3@my.org\n```\n\n_See code: [src/commands/org/generate/password.ts](https://github.com/salesforcecli/plugin-user/blob/3.8.3/src/commands/org/generate/password.ts)_\n\n## `sf org list users`\n\nList all locally-authenticated users of an org.\n\n```\nUSAGE\n  $ sf org list users -o \u003cvalue\u003e [--json] [--flags-dir \u003cvalue\u003e] [--api-version \u003cvalue\u003e]\n\nFLAGS\n  -o, --target-org=\u003cvalue\u003e   (required) Username or alias of the target org. Not required if the `target-org`\n                             configuration variable is already set.\n      --api-version=\u003cvalue\u003e  Override the api version used for api requests made by this command\n\nGLOBAL FLAGS\n  --flags-dir=\u003cvalue\u003e  Import flag values from a directory.\n  --json               Format output as json.\n\nDESCRIPTION\n  List all locally-authenticated users of an org.\n\n  For scratch orgs, the list includes any users you've created with the \"org create user\" command; the original scratch\n  org admin user is marked with \"(A)\". For other orgs, the list includes the users you used to authenticate to the org.\n\nALIASES\n  $ sf force user list\n\nEXAMPLES\n  List the locally-authenticated users of your default org:\n\n    $ sf org list users\n\n  List the locally-authenticated users of the specified org:\n\n    $ sf org list users --target-org me@my.org\n```\n\n_See code: [src/commands/org/list/users.ts](https://github.com/salesforcecli/plugin-user/blob/3.8.3/src/commands/org/list/users.ts)_\n\n\u003c!-- commandsstop --\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsalesforcecli%2Fplugin-user","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsalesforcecli%2Fplugin-user","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsalesforcecli%2Fplugin-user/lists"}