mirror of
https://github.com/bitwarden/help
synced 2025-12-15 07:43:48 +00:00
Release Documentation (#653)
* Stage (#636) * Initial Draft. To do: "How it Works" + Event Logs, User Types, Plans & Pricing, Release Notes. * whoops, missed one * Merge latest into working (#616) * Update proof-of-concept.md (#607) The "Download Bitwarden" link was going to the Apple Store (https://get.bitwarden.com/) rather than the "Downloads" page (https://bitwarden.com/download/). * Update proof-of-concept.md (#610) * Create enterprise-feature-list.md (#611) * Azure SSO HiFi Documentation (#584) * azure HiFi documentation * finalize azure * typo fixes * Google Workspace HiFi SSO Documentation (#605) * Duo HiFi documentation (#598) * Buncha Stuff (#612) * clarification on where to find legacy mac .dmg * tip for update email address * code vetting security faq * /managing-items/ refactor * two-step login 'remember me' duration * small updates, including denoting purpose of the globe icon * additional tip for deleting users in a self-host org! * uri component pieces * encryption key edit * importing cleanup * notes re: importing on file attachements * Removes custom Safari shortcut docs (#499) Bitwarden 1.25.0 on MacOS with Safari seems to use the standard MacOS shortcut for autofill (`Cmd + Shift + L`) and the custom Safari shortcuts no longer work (`Cmd + \ or Cmd + 8 or Cmd + Shift + P`). * Update Microsoft Store Installation path (#614) * Correct path for Microsoft Store app (#615) Co-authored-by: Andrea Lebron <78605241+alebr-on@users.noreply.github.com> Co-authored-by: baylorrandolph <70168800+baylorrandolph@users.noreply.github.com> Co-authored-by: Charles Renwick <crenwick@users.noreply.github.com> Co-authored-by: Alex <abanay@bitwarden.com> * mpwr event logging * mpwr user permissions * admin pw reset 2nd draft * final(ish) draft * password reprompt * initial bwdc updates (to do: update cli login procedure) * update personal api key article to better distingush from org api key * refactors bwdc desktop app article * clearer instructions for getting api key * bwdc cli login scheme * Bulk Org User Actions * export event logs * cli get notes * send cli --maxAccessCount * autofill on page load enhancements * onpageload TOTP copy * release notes & typo Co-authored-by: Andrea Lebron <78605241+alebr-on@users.noreply.github.com> Co-authored-by: baylorrandolph <70168800+baylorrandolph@users.noreply.github.com> Co-authored-by: Charles Renwick <crenwick@users.noreply.github.com> Co-authored-by: Alex <abanay@bitwarden.com> * typo fix * fix * fix * fix * mpwr final * mpw reprompt - better gif * finalize event logs * fixes to autofill o.p.l. & better screenshot * directory connector large sync * reorder rn * edits from cscharf * fix date * mp re-prompt warning * mobile re-prompt notes * downcase it * semi-vague timeline tweak Co-authored-by: Andrea Lebron <78605241+alebr-on@users.noreply.github.com> Co-authored-by: baylorrandolph <70168800+baylorrandolph@users.noreply.github.com> Co-authored-by: Charles Renwick <crenwick@users.noreply.github.com> Co-authored-by: Alex <abanay@bitwarden.com>
This commit is contained in:
committed by
GitHub
parent
8249a78f54
commit
9be8c67fa8
@@ -12,7 +12,7 @@ The Directory Connector CLI is suited toward work in environments where a deskto
|
||||
|
||||
## Getting Started
|
||||
|
||||
Complete the following steps to get started with the Bitwarden Directory Connector CLI:
|
||||
To get started using the Bitwarden Directory Connector CLI:
|
||||
|
||||
1. Download the CLI from one of the following links:
|
||||
- [{% icon fa-windows %} Windows CLI](https://vault.bitwarden.com/download/?app=connector&platform=windows&variant=cli-zip)
|
||||
@@ -48,28 +48,32 @@ Complete the following steps to get started with the Bitwarden Directory Connect
|
||||
|
||||
### login
|
||||
|
||||
Use the `login` command to login to Directory Connector with your Bitwarden Account. You must be an Admin or Owner for your Organization to use Directory Connector (for more information, see [User Types and Access Controls]({% link _articles/organizations/user-types-access-control.md %})).
|
||||
```
|
||||
bwdc login [options] [email] [password]
|
||||
```
|
||||
Use the `login` command to login to Directory Connector with your [Organization API Key]({{site.baseurl}}/article/public-api/#authentication). If you don't have the API Key, reach out to an [Organization Owner]({{site.baseurl}}/article/user-types-access-control/). There are a few ways to use the `login` command:
|
||||
|
||||
Options include:
|
||||
- `--method`: Use this options to specify the [Two-step Login method]({% link _articles/two-step-login/setup-two-step-login.md %}) to use.
|
||||
- `0` = Authenticator App
|
||||
- `1` = Email
|
||||
- `3` = YubiKey
|
||||
- `--code`: Use this option to specify the [Two-step Login]({% link _articles/two-step-login/setup-two-step-login.md %}) code for the specified `method`.
|
||||
- `--sso`: Use this option to [Login with SSO]({% link _articles/login-with-sso/about-sso.md %}). Selecting this option will open the SSO Login Flow in your Web Browser. For more information, see [Access your Vault Using SSO]({% link _articles/login-with-sso/sso-access-your-vault.md %}).
|
||||
- By itself:
|
||||
|
||||
For example:
|
||||
```
|
||||
bwdc login
|
||||
```
|
||||
|
||||
{% callout warning %}
|
||||
Contrary to the following example, it's generally not recommended to enter your password inline, as this will save it to the history of the shell. Leaving the password out of the initial command will cause Bitwarden to prompt for it, which will not save it.
|
||||
{% endcallout %}
|
||||
Passing `bwdc login` by itself will prompt you to subsequently enter `client_id` and `client_secret`.
|
||||
- With parameters:
|
||||
|
||||
```
|
||||
bwdc login bwuser@gmail.com mystrongpassword --method 0 --code 204678
|
||||
```
|
||||
```
|
||||
bwdc login organization.b5351047-89b6-820f-ad21016b6222 yUMB4trbqV1bavhEHGqbuGpz4AlHm9
|
||||
```
|
||||
- With saved environment variables:
|
||||
|
||||
```
|
||||
BW_CLIENTID="organization.b5351047-89b6-820f-ad21016b6222"
|
||||
BW_CLIENTSECRET="yUMB4trbqV1bavhEHGqbuGpz4AlHm9"
|
||||
|
||||
bwdc login
|
||||
```
|
||||
|
||||
Saving the environment variables `BW_CLIENTID` and `BW_CLIENTSECRET` allows you to login to Directory Connector using only `bwdc login`, which will check for those variables and use them if present.
|
||||
|
||||
If these environment variables aren't present, you will be prompted to enter your `client_id` and `client_secret`.
|
||||
|
||||
### logout
|
||||
|
||||
@@ -135,7 +139,9 @@ Options include:
|
||||
- `okta.token <token>`
|
||||
- `onelogin.secret <secret>`
|
||||
|
||||
{% callout success %}
|
||||
`ldap.password`, `azure.key`, `gsuite.key`, `okta.token`, and `onelogin.secret` can **only** be modified from the CLI using `bwdc config`, or from the [Desktop Application]({% link _articles/directory-connector/directory-sync-desktop.md %}).
|
||||
{% endcallout %}
|
||||
|
||||
### data-file
|
||||
|
||||
|
||||
Reference in New Issue
Block a user