The KeyMail Installation process (and the KeyMail Settings screen), require entry of the following information: email address, username, and password for the email account through which KeyMail is to process emails. The email account password field supports up to 184 characters. The values for these settings can usually be found in the email program normally used to send email (from outside of Keystroke). Below are default settings for common email providers.
Gmail settings:
- Gmail SMTP Server Address: smtp.gmail.com
- Gmail Port: 465 or 587
- Gmail SUse SSL (leave Off for TLS): OFF
- Gmail User Name: the full Gmail email address (e.g. myemail@gmail.com)
- Gmail Password: See page 13 of the KeyMail Service Installation for details about using the recommended OAuth2 verification method (which has replaced the App Passwords method).
- The verification method for using the specified GMail account to send emails has been changed to use the OAuth2 method instead of UserName/Password (if Password is blank). OAuth2 verifies access to the GMail account by checking with Google if the KeyMail connection has been given "Send email on your behalf" access to the specified Google account. If needed, KeyMail.exe (through Google) will automatically prompt to grant this access (when the program starts, when an email is sent, and/or when the Settings screen is saved). If the default browser is not already logged into the specified account then Google will ask for a log in. Once logged in with the specified account, Google displays the "KeyMail wants to access your Google Account" message. Click the "Allow" button to proceed. This should be a one time process and should not have to be done again unless using a different Gmail (Google) account or the access permission on the account was removed.
- To switch an existing Settings ID to use OAuth2 instead of the Password, simply delete the Password. Note, once this is done the Password field will disappear. It can be brought back by temporarily changing the SMTP Server to something other than "smtp.gmail.com".
- To view or remove access granted to KeyMail for using a GMail account, set the browser to myaccount.google.com, select "Security" from the list on the left side of the page (may require a login first by clicking "Go to Google Account" in the upper right corner). On the "Security" page scroll down to "Your connections to third-party apps" and click on "KeyMail" (may need to click on "See all connections" if it is not displayed). From there you can view the details and/or click to "Remove access" or "Delete all connections" (both do the same thing). Removing the access prevents KeyMail from being able to send emails through the specified GMail account until access is granted again. KeyMail.exe automatically prompts to do this each time an email is sent or when leaving the Settings screen. However, the Service version of KeyMail (KMailSvc.exe) cannot do this and displays errors until KeyMail.exe is used to add the authorized access.
Outlook / Windows Live Mail settings:
- Windows Live SMTP Server Address: smtp.live.com
- Windows Live Port: 587
- Windows Live Use SSL (leave Off for TLS): OFF
- Windows Live User Name: the full Outlook/Windows Live email address (e.g. myemail@live.com)
- Windows Live Password: the Outlook/Windows Live Password
MSN settings:
- MSN SMTP Server Address: smtp.live.com
- MSN Port: 587
- MSN Use SSL (leave Off for TLS): OFF
- MSN User Name: the full MSN email address (e.g. myemail@msn.com)
- MSN Password: the MSN Password
Yahoo! Mail settings:
- Yahoo! SMTP Server Address: smtp.mail.yahoo.com
- Yahoo! Port: 587
- Yahoo! Use SSL (Leave Off for TLS): OFF
- Yahoo! User Name: the full Yahoo! email address (e.g. myemail@yahoo.com)
- Yahoo! Password: the Yahoo! Password
NOTE: Must use "Manage app Passwords" at Yahoo.com. Select Settings, Account Security (on the left) from
https://login.yahoo.com/account/personalinfo
Then select Other App and generate a code. Use this code as the KeyMail password and test it.
Hotmail settings:
Now uses Outlook/Windows Live Mail. See above
See:
KeyMail - Common Errors and Fixes