The screens may look different depending on the order of your actions and whether you've worked with Google Console previously, but the simplest flow is as follows:
- Go to https://console.cloud.google.com/ and hit Create or select a project.
Give it a name, skip the organisation field.
- Now we need to configure OAuth Consent Screen. With the project selected go to APIs & Services > OAuth consent screen on the sidebar.
Choose External user type.
Fill in the app name and contact information.
- Next is an important step of selecting what type of data the application is allowed to access. At the following screen select Add or remove scopes.
You may select appropriate scopes from the list, or just type in manually "https://mail.google.com", "email", and "profile", separated by commas.
- This is not strictly necessary but you may want to add your email address as a test user. Then you can leave the app in testing mode (no actions required) but Eppie will only be able to authenticate with the test user account.
If you skip the above step, then you will need to switch to production mode. Go to APIs & Services > OAuth consent screen again and Publish app.
Later whenever you are authenticating with Eppie-CLI at you Gmail account, you will get a warning from Google that the application has not been verified. Despite the warning you will be able to continue with the authentication by chosing Advanced dropdown.
- Lastly, create the application credentials. Go to APIs & Services > Credentials > Create credentials > OAuth Client ID.
And you are done. Pass the Client ID and Client secret as arguments when launchig Eppie-CLI from the console as described here.
- Go to Azure Portal and log in or create an account. Choose Microsoft Entra ID on the dashboard or in the side menu. Here we will register Eppie-CLI so Microsoft's servers recognize it and allow it to access your Outlook mailbox.
- Select App registrations > New registration.
Fill in the name, select the third option for the Supported account types: Accounts in any organizational directory (Any Microsoft Entra ID tenant - Multitenant) and personal Microsoft accounts (e.g. Skype, Xbox).
Also, add a redirect URI: choose Public client/native (mobile & desctop), type in http://127.0.0.1.
Hit Register.
You will need the Application (client) ID later when running Eppie-CLI.
- Now let's set API permissions. These will be requested on the user consent screen when you log into your mailbox with Eppie. Hit API permissions > Add permission.
Choose Microsoft Graph from the side menu.
Select Delegated permissions. Eppie needs permissions to read and write into your mailbox, send new emails and see your profile. Look for theses checkboxes:
OpenId permissions > offline_access,
IMAP > IMAP.AccessAsUser.All,
SMTP > SMTP.Send,
and User > User.Read
And this is it. Now you can pass the application ID to Eppie-CLI as an argument as shown here, and it will be authorized to access your Microsoft Outlook mailbox.