layout | title | categories | featured | popular | tags | ||||
---|---|---|---|---|---|---|---|---|---|
article |
Match detection for URIs |
|
false |
false |
|
A login item stored in your vault can have one or more URI{:target="_blank"} values associated with it. URIs can relate your login to a website address (URL), server IP address, mobile app package ID, and more. URIs are important values for a login since they determine how the auto-fill functions in Bitwarden will behave.
A well-formed URI also has a protocol at the beginning of it. The most common protocol that many of us are familiar with is the http://
protocol used for a website address.
The protocol can also have special meaning in Bitwarden:
http://
orhttps://
tells Bitwarden that this is a website address. Example:https://www.google.com
androidapp://
tells Bitwarden that this is an android application package ID (or package name). Example:androidapp://com.twitter.android
. Android apps typically follow reverse domain name notation{:target="_blank"}.
{% note %}
If a URI omits the protocol, http://
is assumed.
{% endnote %}
Each URI for a login item also has an associated "match detection" value. The match detection value determines whether or not Bitwarden will offer the login as an available option when performing an auto-fill.
While editing a login you can adjust the match detection value for a given URI by selecting the {% icon fa-cog %} Options button next to the URI's value.
The following match detection options are available:
Base domain
{% note %} Base domain is the default match detection value for all URIs. {% endnote %}
The base domain is defined as the second-level domain plus the top-level domain of the given URI. A URI with a value of https://www.google.com
would have a base domain value of google.com
.
Example:
- URI base domain value:
https://www.google.com
- Matches:
http://google.com
,https://accounts.google.com
,https://sub.accounts.google.com
,https://accounts.google.com/page.html
- Not matches:
https://google.net
,https://yahoo.com
Host
The host{:target="_blank"} is defined as the hostname plus an optional port of the given URI. A URI with a value of https://sub.domain.com:4000
would have a host value of sub.domain.com:4000
.
Example:
- URI host value:
https://sub.domain.com:4000
- Matches:
http://sub.domain.com:4000
,http://sub.domain.com:4000/page.html
- Not matches:
https://domain.com
,https://sub.domain.com
,https://sub2.domain.com
,https://sub.domain.com:5000
Starts with
The "starts with" option requires that the current website/application URI must start with the value defined in the URI. A URI with a value of https://sub.domain.com/path/page.html?query=123
starts with
https://sub.domain.com/path/
.
Example:
- URI starts with value:
https://sub.domain.com/path/
- Matches:
https://sub.domain.com/path/
,https://sub.domain.com/path/page.html
- Not matches:
https://sub.domain.com/path
(notice the missing trailing slash),https://sub.domain.com
,https://sub.domain.com:4000/path/page.html
(has a port)
Regular expression
{% warning %} 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. {% endwarning %}
The regular expression option allows you to write any simple or complex regular expression{:target="_blank"} to match the current website/application URI.
Example:
- URI regex value:
^https://.*google.com
- Matches:
https://google.com
,https://sub.google.com
,https://anything.can.go.here.google.com
- Not matches:
http://google.com
(not https),https://yahoo.com
Exact
The "exact" option requires that the current website/application URI exactly match the value defined in the URI.
Example:
- URI exact value:
https://www.google.com/page.html
- Matches:
https://www.google.com/page.html
- Not matches:
http://www.google.com/page.html
(not https),https://www.google.com/page.html?query=123
,https://www.google.com
Never
A URI with match detection set to "Never" will never be offered for auto-fill.
Example:
- URI never value:
https://www.google.com
- Matches: none
- Not matches:
https://www.google.com
,https://google.com
,https://sub.google.com/page.html