Using URIs
Any login item in your vault can have one or more Uniform Resource Identifiers (URIs). A URI can be a website address (URL), a server IP address, a mobile app package ID, and more.
備考
Assigning URIs to login items is required if you want to use auto-fill in various Bitwarden apps.
Well-formed URIs should include a scheme at the beginning, for example the https:// scheme to securely reference a website address. If no scheme is specified, http:// is assumed.
tip
Most Bitwarden apps allow you to Launch an website or app directly from your vault. Without a scheme, launching won't work properly.
Schemes include:
http://orhttps://reference website addresses (for example,https://github.com)androidapp://references an Android application package ID or name (for example,androidapp://com.twitter.android)
It can be tricky to obtain URIs for mobile apps. Here are a few tips for getting URIs on iOS and Android apps:
On the app's login screen, use autofill to open Bitwarden.
Once Bitwarden is open, select the icon on the top right corner of the screen.
The URI that has been included in the new vault item (if permitted by the app), can be copied and pasted into any existing login items.
Visit the app's page in the Google Play Store.
Locate the share button and copy the link to your clipboard.
Paste the copied link somewhere you can read it. The link will look like:
https://play.google.com/store/apps/details?id=com.twitter.android.
The value afterid=is your URI, in this casecom.twitter.android.
Each URI assigned to a login has an associated match detection option. This option determines when Bitwarden will offer the login as available for auto-fill, typically determined by matching against specific component pieces. The following graphic breaks down component pieces of a URI:
Bitwarden browser extensions and mobile apps allow you to select a Default match detection behavior from the options listed next by navigating to Settings → Auto-fill → Default URI match detection. You can set override the globally-set detection on an item-by-item basis in all Bitwarden apps.
Base domain matching is the default option.
Selecting Base domain will prompt Bitwarden to offer auto-fill when the top-level domain and second-level domain of the URI match the detected resource. Base domain matching is implemented to work with any country code top-level domain (for example, .it or .co.uk)
For example, if the URI https://google.com uses base domain match detection:
Selecting Host will prompt Bitwarden to offer auto-fill when the hostname and (if specified) port of the URI matches the detected resource.
For example, if the URI https://sub.domain.com:4000 uses host match detection:
URL | Auto-fill? |
|---|---|
| |
| |
| |
| |
| |
|
Selecting Starts with will prompt Bitwarden to offer auto-fill when the detected resource starts with the URI, regardless of what follows it.
For example, if the URI https://sub.domain.com/path/ uses starts with match detection:
URL | Auto-fill? |
|---|---|
| |
| |
| |
https://sub.domain.com:4000/path/page.html (interrupted with a port) | |
https://sub.domain.com/path (absent trailing slash) | |
注意
Regular expressions are an advanced option and can be quite dangerous if used incorrectly. You should not use this option if you do not know exactly what you are doing.
Selecting Regular expression will prompt Bitwarden to offer auto-fill when the detected resource matches a specified regular expression. Regular expressions are always case insensitive.
Unsafe example
If the URI ^https://.*google\.com$ uses regular expression match detection:
URL | Auto-fill? |
|---|---|
| |
| |
| |
| |
|
This probably matches more than what is intended. Consider avoiding periods (.), which unless escaped (\) match on any character.
Safe example
If the URI ^https://[a-z]+\.wikipedia\.org/w/index\.php uses regular expression match detection:
URL | Auto-fill? |
|---|---|
https://en.wikipedia.org/w/index.php?title=Special:UserLogin&returnto=Bitwarden | |
https://pl.wikipedia.org/w/index.php?title=Specjalna:Zaloguj&returnto=Bitwarden | |
| |
| |
|
Selecting Exact will prompt Bitwarden to offer auto-fill when the URI matches the detected resource exactly.
For example, if the URI https://www.google.com/page.html uses exact match detection:
URL | Auto-fill? |
|---|---|
| |
| |
| |
|
Selecting Never will prompt Bitwarden to never offer auto-fill for the item.