|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Basic Auto-Type InformationKeePass features an "Auto-Type" functionality. This feature allows you to define a sequence of keypresses, which KeePass can automatically perform for you. The simulated keypresses can be sent to any other currently open window of your choice (browser windows, login dialogs, ...). By default, the sent keystroke sequence is For TAN entries, the default sequence is KeePass 1.x Only
You can freely define your own Auto-Type sequence: simply write the sequence into the
notes field of the entry, prefixed with "Auto-Type: ".
Your notes could look something like this:You can write any notes here. My e-mail I used to register: me@example.com Auto-Type: {USERNAME}{TAB}{TAB}Some fixed string{TAB}{PASSWORD}{ENTER} Here you can continue with your notes if you wish...As you can see, the only important thing is that the auto-type sequence is prefixed using " Auto-Type: " and is one single line. An auto-type sequence cannot
be defined using two or more lines.If you define two or more auto-type sequences, the first one is used. KeePass 2.x Only
Auto-Type can be configured individually for each entry using the
Auto-Type tab page on the entry dialog (select an entry → Edit Entry).
On this page you can specify a default sequence and customize specific
window/sequence associations.Two-Channel Auto-Type Obfuscation is supported (making Auto-Type resistant against keyloggers). Additionally, you can create customized window/sequence associations, which override the default sequence. You can specify different keystroke sequences for different windows for each entry. For example, imagine a webpage, to which you want to login, that has multiple pages where one can login. These pages could all look a bit different (on one you could additionally need to check some checkbox – like often seen in forums). Here creating customized window/sequence associations solves the problems: you simply specify different auto-type sequences for each windows (identified by their window titles). Invoking Auto-Type:
All methods are explained in detail below. Input Focus: Requirements and LimitationsRights: Remote Desktops and Virtual Machines: When performing auto-type into a remote desktop or virtual machine
window, the following characters may be problematic (depending on the
exact circumstances) and should therefore be avoided, if possible:
Wayland: Context Menu: 'Perform Auto-Type' CommandThis method is the one that requires the least amount of configuration and is the simpler one, but it has the disadvantage that you need to select the entry in KeePass which you want to auto-type. The method is simple: right-click on an entry of your currently opened database and click 'Perform Auto-Type' (or alternatively press the Ctrl+V shortcut for this command). The window that previously got the focus (i.e. the one in which you worked before switching to KeePass) will be brought to the foreground and KeePass auto-types into this window. The sequence which is auto-typed depends on the window's title. If you didn't specify any custom window/sequence associations, the default sequence is sent. If you created associations, KeePass uses the sequence of the first matching association. If none of the associations match, the default sequence is used. Global Auto-Type Hot KeyThis is the more powerful method, but it also requires a little bit more work/knowledge, before it can be used. Simple Global Auto-Type Example:
The KeePass entry title Notepad is matched with the window title of Notepad and the default Auto-Type sequence is typed. How It Works - Details: KeePass registers a system-wide hot key for auto-type. The advantage of this hot key is that you don't need to switch to the KeePass window and select the entry. You simply press the hot key while having the target window open (i.e. the window which will receive the simulated keypresses). By default, the global hot key is Ctrl+Alt+A (i.e. hold the Ctrl and Alt keys, press A and release all keys). You can change this hot key in the options dialog (main menu 'Tools' → 'Options' → tab 'Integration'/'Advanced'): here, click into the global auto-type hot key textbox and press the hot key that you wish to use. If the hot key is usable, it will appear in the textbox. When you press the hot key, KeePass looks at the title of the currently opened window and searches the currently opened database for usable entries. If KeePass finds multiple entries that can be used, it displays a selection dialog. An entry is considered to be usable for the current window title when at least one of the following conditions is fulfilled:
The second condition has been mentioned already, but the first one is new. By using entry titles as filters for window titles, the configuration amount for auto-type is almost zero: you only need to make sure that the entry title is contained in the window title of the window into which you want the entry to be auto-typed. Of course, this is not always possible (for example, if a webpage has a very generic title like "Welcome"), here you need to use custom window/sequence associations. KeePass 1.x Only
Custom window/sequence associations can be specified using the Notes field of entries.
My e-mail I used to register: me@example.com Auto-Type: {USERNAME}{TAB}{TAB}Some fixed string{TAB}{PASSWORD}{ENTER} Auto-Type-Window: Some Website - Welcome* Here you can continue with your notes if you wish...If you now have a window open that starts with "Some Website - Welcome" and press the global auto-type hot key combination, KeePass performs the auto-type sequence above. Some sites, notably banks, use multi-page login schemes. You can use Auto-Type-Window strings to automate these sites.
You can also use Auto-Type-Window strings to standardize your LAN login
in one KeePass entry.As many Auto-Type-Window strings per entry can be defined as you wish.Also, one sequence can be used for multiple windows. For this, first define a window/sequence pair as normal, then continue by appending '-' and a number, starting with 1. Example: Auto-Type: {USERNAME}{TAB}{PASSWORD}{ENTER} Auto-Type-Window: Some Dialog - * Auto-Type-1: {USERNAME}{ENTER} Auto-Type-Window-1: * - Editor Auto-Type-Window-1: * - Notepad Auto-Type-Window-1: * - WordPad Auto-Type-2: {PASSWORD}{ENTER} Auto-Type-Window-2: Some Web Page - *Here, the Auto-Type-1 sequence will be used for all Auto-Type-Window-1
windows.Custom window associations override the KeePass entry title. If any custom window associations are specified, they will be the only item(s) used to determine a match and the KeePass entry title will be ignored. KeePass 2.x Only
Custom window/sequence associations can be specified on the 'Auto-Type' tab
page of each entry.The associations complement the KeePass entry title. Any associations specified will be used in addition to the KeePass entry title to determine a match. Auto-Type window definitions, entry titles and URLs are Spr-compiled, i.e. placeholders, environment variables, field references, etc. can be used. Auto-Type Keystroke SequencesAn auto-type keystroke sequence is a one-line string that can contain placeholders and special key codes. A complete list of all supported placeholders can be found on the page Placeholders. The special key codes can be found below. Above you've seen already that the
default auto-type is Of course, keystroke sequences can also contain simple characters to be sent.
For example, the following string is perfectly valid as keystroke sequence string: KeePass 1.x Only
Special key codes are case-sensitive.
KeePass 2.x Only
Special key codes are case-insensitive.
Special Keys:
KeePass 1.x Only
KeePass 2.x Only
Additionally, some special commands are supported:
KeePass 2.x Only
KeePass 2.x Only
{VKEY X F} :This command sends the virtual key of value X. The parameter F is optional and may be a combination of the following values:
The values The values On Linux systems, KeePass automatically converts most Windows virtual key codes
to Linux key codes (i.e. the
{VKEY ...} command to change the state of the
Shift, Ctrl and
Alt modifiers. For this, use + ,
^ and % instead (see above).
KeePass 2.x Only
Keys and special keys (not placeholders or commands) can be repeated by
appending a number within the code. For example, {TAB 5}
presses the Tab key 5 times.
Examples:
Toggling Checkboxes: Pressing Non-Default Buttons: Higher ANSI Characters: Target Window FiltersWhen creating a custom window/sequence association, you need to tell KeePass how the matching window titles look like. Here, KeePass supports simple wildcards:
KeePass 1.x Only
Other wildcards aren't supported. The * wildcard must not be in
the middle of a string.For example, *Windows*Explorer*
won't match Windows Explorer ,
it will only match Windows*Explorer ,
i.e. the middle * character is treated as '*' text character
instead of a wildcard.
KeePass 2.x Only
Wildcards may also appear in the middle of patterns.
For example, *Windows*Explorer* would match
Windows Internet Explorer .Additionally, matching using regular expressions is supported. In order to tell KeePass that the pattern is a regular expression, enclose it in // . For example, //B.?g Window// would
match Big Window , Bug Window and Bg Window .
By using wildcards, you can make your auto-type associations browser-independent. See the usage examples for more information. Change Default Auto-Type SequenceThe default auto-type sequence (i.e. the one which is used when you don't specify
a custom one) is KeePass 1.x Only
The default auto-type sequence can be changed in the Auto-Type configuration
dialog. This dialog can be found in 'Tools' → 'Options' →
'Advanced' → 'Auto-Type'.KeePass 2.x Only
By default, entries inherit the auto-type sequence of their containing group.
Groups also inherit the auto-type sequence of their parent groups. There is
only one top group (the first group contains all other groups). Consequently, if
you change the auto-type sequence of this very first group, all other groups
and their entries will use this sequence. Practically, this is a global override.
To change it, right-click on the first group, choose 'Edit Group' and switch
to the 'Auto-Type' tab.
Usage ExampleNow let's have a look at a real-world example: logging into a website. In this example, will we use the global auto-type hot key to fill out the login webpage. First open the test page, and afterwards create a new entry in KeePass with title Test Form and a user name and password of your choice. Let's assume the global auto-type hot key is set to Ctrl+Alt+A (the default). KeePass is running in the background, you have opened your database and the workspace is unlocked. When you now navigate to the test page and are being prompted for your user name and password, just click into the user name field and press Ctrl+Alt+A. KeePass enters the user name and password for you! Why did this work? The window title of your browser window was "Test Form - KeePass - Internet Explorer" or "Test Form - KeePass - Mozilla Firefox", depending on the browser you are using. Because we gave the entry in KeePass the title Test Form, the entry title is contained in the window title, therefore KeePass uses this entry. Here you see the huge advantages of auto-type: it not only doesn't require any additional browser software (the browser knows nothing of KeePass – there are no helper browser plugins required), it is also browser-independent: the one entry that you created within KeePass works for Internet Explorer and Mozilla Firefox (and other browsers) without requiring any modifications or definitions. When you would use window/sequence associations
(instead of entry title matching), you can achieve the same
browser-independent effect using wildcards: you could for example have used
|
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||