* 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>
11 KiB
layout, title, categories, featured, popular, hidden, tags, order
| layout | title | categories | featured | popular | hidden | tags | order | ||
|---|---|---|---|---|---|---|---|---|---|
| article | Get Started with Organizations |
|
false | false | false |
|
06 |
Why Bitwarden Organizations?
Password managers like Bitwarden make it easy to store and access unique and secure passwords across all of your devices, keeping your online accounts safer than ever! Using Bitwarden, you won't need to dangerously repeat simple passwords or leave them exposed in unencrypted formats like spreadsheets, documents, or sticky notes.
Bitwarden Organizations add a layer of collaboration and sharing to password management for your family, team, or enterprise, allowing you to securely share common information like office wifi passwords, online credentials, or shared company credit cards. Secure sharing through Organizations is safe and easy.
This article will help you get started with a free 2-person Organization so you can experience secure sharing in no time.
What are Organizations?
Bitwarden Organizations relate users and Vault items together for secure sharing of Logins, Notes, Cards, and Identities. Organizations could be a family, team, company or any group of people that needs to securely share data. Organizations have a unique Vault, where administrators can manage the Organization's items, users, and settings:
{% image /organizations/org-vault-admin.png Organization Vault %}
Comparing Organizations with Premium
The key thing to know is that Organizations unlock access to secure sharing between users. Premium Individual plans unlock premium password security and management features, including advanced 2FA options, the Bitwarden Authenticator (TOTP), encrypted file attachments, and more, but Premium Individual does not include secure data sharing.
Paid Organizations (Families, Teams, or Enterprise) automatically include those premium features (advanced 2FA options, Bitwarden Authenticator (TOTP), etc.) for every user enrolled in the Organization.
Setup Bitwarden Accounts
Free Bitwarden Organizations allow for 2 users to securely share data. You might use a free Organization to share with friend or partner, or to test Organizations before upgrading to a different plan.
Bitwarden provides applications on lots of devices, including Browser Extensions, Mobile Apps, Desktop Apps, and a CLI, but for the purposes of this guide we'll focus on the Web Vault{:target="_blank"}. The Web Vault provides the richest Bitwarden experience for administering your Organization.
Sign up for Bitwarden
Create a Bitwarden account{:target="_blank"}, and make sure that you pick a strong and memorable Master Password. We even recommend writing down your Master Password and storing it in a safe location.
{% callout success %} Don't forget your Master Password! Bitwarden is a Zero knowledge/Zero Trust solution, meaning that the team at Bitwarden, as well as Bitwarden systems themselves, have no knowledge of, way to retrieve, or way to reset your Master Password. {% endcallout %}
Once your account is created, log in to your Web Vault{:target="_blank"} and verify your account's email address to unlock access to all features:
{% image /getting-started/verify-email.png Send Verification Email %}
Sign up for Bitwarden again
In order to use your free 2-person Organization for secure sharing, you'll need to have 2 Bitwarden accounts to share between. Once your first Bitwarden account is setup, follow the same procedure (or help your friend or partner to do so) to setup the other account.
{% callout success %} Bitwarden Organizations have a deep level of user-level access controls. Whichever user you proceed to setup your Organization with will be the Owner. {% endcallout %}
Setup your Organization
To setup your Organization:
-
In your Web Vault{:target="_blank"}, select the New Organization button:
{%image /organizations/new-org-button-overlay.png Create New Organization %}
-
Enter an Organization Name and a Billing Email we can reach you at. In this guide we're setting up a free Organization, so you won't be billed for anything!
-
Choose your Plan. Bitwarden offers Organizations suited to any need, but in this case select Free.
-
Scroll down and select Submit to finish creating your Organization.
Get to know your Organization
Once created, you'll land in your Organization Vault, which is the central hub for all things sharing and Organization administration. As the Organization Owner, you'll be able to see your Vault, to Manage users and Collections, to use some Bitwarden Tools, and to configure your Organization's Settings:
{% image /getting-started/org-vault.png Organization Vault %}
Get to know Collections
Collections are an important part of a Bitwarden Organization; they represent the logical grouping of shared Vault items that belong to your Organization. Your Organization comes pre-loaded with a Default Collection and an Unassigned tag. With a free Organization, you can create up to 2 Collections using the Manage tab:
{% image /getting-started/collections.png Collections %}
{% callout success %} In a lot of ways, Collections are like the Folders you might use to organize your Personal Vault. A key difference is that items that belong to your Organization must be included in at least 1 Collection. {% endcallout %}
Add a User to your Organization
Now that you're familiar with your Organization, it's a good time to add the other Organization member you'll be sharing with. To ensure the security of your Organization, Bitwarden applies a 3-step process for onboarding a new member, Invite → Accept → Confirm.
Invite
As the Organization Owner, invite a new member:
-
In your Organization Vault, open the Manage tab and select the {% icon fa-plus %} Invite User button:
{% image /organizations/org-people-invite.png %}
-
Enter the Email of your second member, which should match the email they signed up for Bitwarden with. You can also choose the User Type and Access Controls assigned to this user, including which Collections they can access.
-
Select Save to send the invitation to the designated email address.
Once your invitation is sent, inform your new member and help them accept the invitation.
Accept
As the newly invited member, open your email inbox and look for an email from Bitwarden inviting you to join an Organization. Clicking the link in the email will open a Bitwarden Web Client invitation window:
{% image organizations/user-accept-updated.png Bitwarden Invitation %}
Since you've already signed up for Bitwarden, select Log In. Fully logging in to your Vault will accept the invitation.
{% callout info %} Invitations expire after 5 days. Make sure you accept the invitation within that window, otherwise the Organization Owner will have to re-invite you. {% endcallout %}
Confirm
Confirm accepted Organization to complete the loop:
-
Log in to your Web Vault{:target="_blank"} and open your Organization.
-
Open the Manage tab and select People from the left-hand menu.
-
Select any
Acceptedusers and use the {% icon fa-cog %} gear dropdown to {% icon fa-check %} Confirm Selected:{% image organizations/org-people-options-overlay.png Confirm an Accepted user %}
-
Verify that the fingerprint phrase on your screen matches the one your new member can find in Settings → My Account:
{% image fingerprint-phrase.png Sample Fingerprint Phrase %}
Each fingerprint phrase is unique to its account, and ensures a final layer of oversight in securely adding users. If they match, select Submit.
Get to know your Vault
Part of the magic of Bitwarden Organizations is that items that belong to you and items that belong to the Organization are accessible side-by-side from your My Vault view, there's no need to maintain separate profiles. Your Organization-enabled Vault has a few new features to check out, first among which is your Collections filters:
{% image organizations/personal-vault-org-enabled.png Organization-enabled Vault %}
Collections are a lot like Folders in that they organize the shared items in your Vault. Like anything else in the Filters menu, selecting a Collection will filter listed Vault items down to only the ones in that Collection.
Shared Items
You probably don't have a shared item yet, but when you do it will be displayed in your Vault with a {% icon fa-share-alt %} Shared icon:
{% image /organizations/collection-shared-item.png Shared Item icon %}
Shared items are owned by the Organization. This means that anyone with permission can alter the item or delete it, which would remove it from your Vault as well.
Share a Login
The last step on the road to secure sharing is to create a shared a Vault item. An existing Vault item can be shared after it's created, but for this guide, we'll focus on creating a new shared Login from your Personal Vault:
- On the {% icon fa-lock %} My Vault page, select the {% icon fa-plus %} Add Item button.
- Fill in all the relevant information for your new Login item (e.g. Username and Password). The item can be anything you want both yourself and the other Organization user to have access to, for example a family streaming account.
- In the Ownership section at the bottom of the Add Item Panel, select your Organization to designate the item for sharing.
- Select one or more Collections to share this item into. Generally, users of two-person Organizations setup access for both users for all Collections. In larger or more complex Organizations, which Collection you share the item into will determine who can access it.
- Select the Save button to finishing creating the shared item.
This new shared item will be accessible to both yourself and the other Organization user! As long as both users can access the Collection it's in, it will appear for both in the Organization Vault and in the My Vault view alongside other personal Vault items.
Congratulations!
You've setup your new Bitwarden accounts, created an Organization, learned a bit about your Vaults, and shared an item! Nice work!