Evernote

Before You Begin

Introduction

This document describes how to configure Oracle Identity Cloud Service to provide Single Sign-On (SSO) for Evernote using SAML.

About Evernote

Evernote is a Software-as-a-Service (SaaS) solution used not only to take notes but also to organize and archive them. This app allows users to create a "note", which can be a piece of formatted text, full webpage, webpage excerpt, photograph, voice memo, or handwritten "ink" note.

After integrating Evernote with Oracle Identity Cloud Service:

• Users can access Evernote using their Oracle Identity Cloud Service login credentials.
• Users can start Evernote using the Oracle Identity Cloud Service My Apps console.
• Admins can assign and revoke user access to the Evernote app using the Oracle Identity Cloud Service administration console.

What Do You Need?

• An Oracle Identity Cloud Service account with authorization rights to manage apps and users (Identity Domain Administrator or Application Administrator).
• An Evernote account with authorization rights to configure federated authentication.

Configuring the Evernote App in Oracle Identity Cloud Service

Use this section to register and activate the Evernote app, and then assign users to the app.

Registering and Activating the Evernote App

1. Access the Oracle Identity Cloud Service administration console, select Applications, and then click Add.

2. Click App Catalog.

3. Search for Evernote, click Add, and then click Next.

4. Click Download Signing Certificate.

   Tip: Use this file later during the Evernote configuration in the "Configuring SSO for Evernote" section.

5. Click Finish. Oracle Identity Cloud Service displays a confirmation message.

6. Click Activate, and then click Activate Application. Oracle Identity Cloud Service displays a confirmation message.

Assigning Users to the Evernote App

1. On the Evernote app page in Oracle Identity Cloud Service, select Users, and then click Assign. The Assign Users window appears.

2. Select users that you want to assign to Evernote, and then click OK. Oracle Identity Cloud Service displays a confirmation message stating that the Evernote app is assigned to the users that you selected.

Configuring SSO for Evernote

1. Access Evernote as an administrator using the URL: https://www.evernote.com/Login.action.

2. In the lower-left corner of the Evernote home page, select Admin Console.

3. In the left navigation menu, locate SECURITY, and then click Single Sign-On. The Authentication page appears.

4. Use the table to update the federated authentication attributes, and then click Save & Enable.

   This table lists the mandatory federated authentication attributes that you must set to complete the SSO configuration.

   Attribute	Value
   SAML HTTP Request URL	Enter the Sign-in URL/SSO Endpoint: https://<IDCS-Service-Instance>.identity.oraclecloud.com/fed/v1/idp/sso.
   X.509 Certificate	Paste the certificate that you downloaded during the Evernote registration in Oracle Identity Cloud Service. See the "Registering and Activating the Evernote App" section.

   Note: Users who are assigned to the Evernote app in Oracle Identity Cloud Service with the same domain name as the administrator can access Evernote, even if the user does not have an Evernote account.

Verifying the Integration

Use this section to verify that SSO works when initiated from Oracle Identity Cloud Service (IdP Initiated SSO) and from Evernote (SP-initiated SSO).

Verifying Identity Provider Initiated SSO from Oracle Identity Cloud Service

1. Access the Oracle Identity Cloud Services My Profile console using the URL: https://<IDCS-Service-Instance>.identity.oraclecloud.com/ui/v1/myconsole.

2. Log in using credentials for a user that is assigned to the Evernote app. Oracle Identity Cloud Service displays a shortcut to Evernote under My Apps.

3. Click Evernote. The Evernote login page appears.

4. Enter the email address, click Continue, enter the password, and then click Sign in. The Evernote home page appears.

   Tip: Evernote's implementation of SSO requires the user to log in to Evernote again using their password. This is because Evernote Business is an overlay of a business account onto the user's personal account. After the user has authenticated to their account, Evernote uses SSO to grant access to their business account notebooks.

5. In the lower-left corner, click the user icon, and then confirm that the user that is logged in is the same for both Evernote and Oracle Identity Cloud Service.

   This confirms that SSO that is initiated from Oracle Identity Cloud Service works.

Verifying Service Provider Initiated SSO from Evernote

1. Access the Evernote login page using the URL: https://www.evernote.com/Login.action. The Evernote login page appears.

2. Enter the user name, and then click Continue.

3. Enter the password, and then click Sign in. The ACCESS BUSINESS CONTENT page appears.

4. Click Proceed. You are redirected to the Oracle Identity Cloud Service login page.

5. Log in using credentials for a user that is assigned to the Evernote app. The Evernote home page appears.

6. In the lower-left corner, click the user icon, and then confirm that the user that is logged in is the same for both Evernote and Oracle Identity Cloud Service.

   This confirms that SSO that is initiated from Evernote works.

Troubleshooting

Use this section to locate solutions to common integration issues.

Known Issues

Evernote displays the message, "We are unable to identify an Evernote Business user or pending invitation for your email address".

Cause: The email attribute sent by Oracle Identity Cloud Service during SSO doesn't match any existing user in Evernote.

Solution: Ensure that the user that you assign to the Evernote app has an account in both Oracle Identity Cloud Service and Evernote with the same email address.

Oracle Identity Cloud Service displays the message, "You are not authorized to access the app. Contact your system administrator."

Cause 1: The SAML 2.0 integration between the Oracle Identity Cloud Service Evernote app and Evernote is deactivated.

Solution 1:

• Access the Oracle Identity Cloud Service administration console, select Applications, and then select Evernote.
• In the App Details section, click Activate, and then click Activate Application. Oracle Identity Cloud Service displays a confirmation message.

Cause 2: The administrator revokes access for the user at the same time that the user tries to access the Evernote app using Oracle Identity Cloud Service.

Solution 2:

• Access the Oracle Identity Cloud Service administration console, select Applications, and then select Evernote.
• In the App Details section, select Users, and then click Assign to re-assign the user.

Unknown Issues

For unknown issues, contact Oracle Support:

1. Go to https://support.oracle.com.

2. Select Cloud Support, and then sign in with your support credentials.

3. In the Cloud Dashboard, confirm that there are no planned outages in Oracle Identity Cloud Service, and then click Create Service Request.

4. Select Oracle Identity Cloud Service as the service type.

5. Complete your service request.