Articles with the tag:
Close
Changelog
Close
Help Center
Community Server

The authorization keys option

Admin

The Authorization keys option allows you to connect your portal with the third party services like Twitter, Facebook, Dropbox etc. Connecting portal with Facebook, Twitter, Google or LinkedIn is a good idea if you don't want to introduce your portal credentials every time you enter it. Using the third party authorization option you can access your portal with the few mouse clicks choosing the appropriate icon. More than that you can use Facebook and Twitter to facilitate the search of information about people and companies in the CRM module.

Link up your portal with Box, Dropbox, OneDrive and Google to transfer your documents to the Documents module and also to synchronize your accounts with ONLYOFFICE!

If you connect the DocuSign service, you will be able to send files from the Documents module for electronic signature to your portal employees via the DocuSugn service.

The Bitly service connected to your portal will allow you to get shortened invitation links as well as links to documents that have been shared with external users.

Add the Twilio service to be able to call your CRM contacts from a web browser. You can also use Twilio to enable the two-factor authentication.

With the Firebase service, you can receive notifications about the messages sent to you even when you are offline.

Adding the Clickatell or smsc service you will be able to enable the two-factor authentication option and receive an SMS with a code allowing the user to enter the portal.

Integrating the Yahoo service you will be able to import new users from the contact list to your portal.

Once you connect the EasyBib service, you will be able to create bibliographic lists in your documents using the corresponding plugin at the Plugins tab of the Document Editor.

Connect the Wordpress service to easily publish documents on your WordPress website using the corresponding plugin that is available at the Plugins tab of the Document Editor.

If you use the SaaS version, the authorization keys parameters for most services are set up automatically. In the SaaS version, you can connect DocuSign, Twilio and EasyBib services.

Read this article and you will learn how to grant authorization to the third-party services, so that you could connect your accounts from these networks to ONLYOFFICE profile with no problem.

Bare Bones Instructions

If you decide to connect a third party service to portal, proceed through these simple steps

  1. First of all go to the Settings section. To do that click the Settings Icon icon in the right upper corner.

  2. Switch to the Integration tab.

  3. Open the Third Party Services page.

    In this section you will see all the third party services you can connect your portal to. The most important part in the process of establishing the connection is to find application keys. If you want to connect a third party service to your portal, first of all get the application ID (may be called app key, client_id, api key etc.) and Key (app secret, client_secret, api secret etc.). The way to obtain the connection keys differs from service to service. So choose the necessary service and follow the instructions:

    Bitly Bitly Icon

    1. Go to the Bitlink Management page;
    2. Sign in to your account;
    3. Click the Settings icon in the upper right corner;
    4. Go to OPTIONS -> Settings -> Advanced Settings -> API Support;
    5. Copy or write down the LOGIN and API KEY;

    Box.com Boxcom Icon

    1. Go to the box developers page;
    2. Sign in to your account;
    3. Click the Create new app button on the right;
    4. On a new page that opens, select the Partner Integration application type and click Next;
    5. Enter a unique name for your application in the entry field and click the Create App button below;
    6. Click the View Your App button - you will be redirected to the Configuration page;
    7. In the OAuth 2.0 Redirect URI section, enter "https://service.onlyoffice.com/oauth2.aspx" in the Redirect URI field;
    8. In the OAuth 2.0 Credentials section, copy or write down the Client ID and Client secret;
    9. Save the changes made clicking the Save Changes button in the upper right corner of the page.

    Clickatell Clickatell Icon

    1. Sign in to your SMS Platform account;
    2. Select the SMS integrations section in the menu on the left;
    3. Click the Create new integration button;
    4. In the Create new integration dialog, specify a Name and select the HTTP option in the API Type section, then click Next. On the subsequent screens leave default options; click Finish when ready;
    5. After the integration is created, go to the SMS integrations list;
    6. Click the created integration in the list to display details and copy the API Key.

    DocuSign DocuSign Icon

    1. Go to the Admin console of the DocuSign sandbox;
    2. Sign in to your sandbox account;
    3. In the left-side menu, find the Integrations section and open the API and Keys page;
    4. Click the Add Integrator Key button;
    5. Type in your application description and click the Add button;
    6. In the Edit API Integrator Key window, go to the Redirect URIs section, click the Add URI button and add "https://service.onlyoffice.com/oauth2.aspx" in the field that appears;
    7. In the Secret Keys section, click the Add Secret Key button and copy or write down the Secret that will be displayed above;
    8. Click the Save button;
    9. In the My Integrator Keys list, copy or write down the Key of your new key;
    10. Use the "account-d.docusign.com" value as the Authentication endpoint.

      If your application has been moved from the sandbox to a live production account, use the "account.docusign.com" value as the Authentication endpoint.

      For the details on how to move your sandbox Integrator Key to a live production account you can refer to the official DocuSign documentation

    Dropbox Dropbox Icon

    1. Go to Dropbox Developers website;
    2. Sign in to your account;
    3. Click the Create your app link;
    4. Next check the Dropbox API radio button;
    5. Select the following type of access:
      • Full Dropbox - Access to all files and folders in a user's Dropbox.
    6. Introduce your application name;
    7. When creating the first app, you'll also need to check the I agree to Dropbox API Terms and Conditions box;
    8. Click the Create app button;
    9. On your application 'Settings' tab, enter "https://service.onlyoffice.com/oauth2.aspx" in the 'Redirect URIs' field and click the Add button;
    10. Copy or write down App key and App secret which appear on the 'Settings' page.

    EasyBib EasyBib Icon

    1. Go to the EasyBib signup page;
    2. Fill in the form:
      • specify your Name and Email,
      • specify your application Name and Description,
      • in the URL field, introduce "https://service.onlyoffice.com/oauth2.aspx",
      • accept the Terms of service and click Submit.
    3. You will receive the confirmation message to the specified email address. Follow the confirmation link;
    4. After that you will receive another email message with your application information. Copy or write down the apikey.

    Facebook Facebook Icon

    1. Go to Facebook Developers Portal;
    2. Sign in to your account;
    3. Click the My Apps button in the upper right corner and select the Add a New App option (if you have no apps integrated with Facebook, use the Create App button);
    4. In the Create a New App ID window that opens, enter your application name in the Display Name field and verify your Contact Email specified by default;
    5. Click the Create App ID button;
    6. You will be redirected to the + Add Product page. Move the mouse cursor over the Facebook Login section and click the Set Up button;
    7. The Facebook Login product will appear in the PRODUCTS section of left-side menu. Click the Settings link below the Facebook Login product. Find the Client OAuth Settings section;
    8. Introduce "https://service.onlyoffice.com/oauth2.aspx" in the Valid OAuth redirect URIs field;
    9. Click the Save Changes button in the lower right corner;
    10. On the left-side panel, open the Settings -> Basic section;
    11. Copy or write down your App ID and App Secret;
    12. Click the Tools & Support link in the upper right corner of the page and go to the Access Token Tool section;
    13. Copy or write the App Token for searching for contacts in the CRM module.

    Firebase Firebase Icon

    1. Go to Firebase console;
    2. Sign in to your account;
    3. Click the Add project button;
    4. Enter your project name in the Project name field;
    5. Click the Create project button. Once the project is created, click Continue;
    6. Click the Settings icon in the upper left part of the page and then click the Project settings menu item;
    7. In the General section, copy or write down the Project ID and Web API Key;
    8. Switch to the Cloud Messaging section and copy or write down the Sender ID and Server key.

    Google Google Icon

    1. Go to Google APIs console.
    2. Sign in to your account.
    3. Click the Create project button. Enter the Project Name in the corresponding field and click the Create button. Once the project is created, you'll see a notification in the upper right corner of the page. Click on the project name to open it.
    4. Click the Google APIs caption in the upper left corner and select the Library section on the left-side panel.
    5. In the G Suite section, click the Google Drive API link, then click the Enable button.
    6. Return to the API Library page (click the Google APIs caption in the upper left corner and select the Library section on the left-side panel).
    7. Go to the Social section, click the Google+ API link, then click the Enable button.
    8. Click the Google APIs caption in the upper left corner and select the Credentials section on the left-side panel.
    9. Drop-down the Create credentials list and choose the OAuth client ID option.
    10. Click the Configure consent screen button.
    11. Specify the Application name in the corresponding field.
    12. In the Authorized domains field, specify the onlyoffice.com domain and press Enter.
    13. Click Save. The Create OAuth client ID section will open.
    14. In the Application type list, select the Web application radio button.
    15. Introduce "https://service.onlyoffice.com/oauth2.aspx" in the Authorized redirect URIs field and press Enter.
    16. Click the Create button.
    17. Your Client ID and Client secret will be displayed in a new window. Copy or write down them.

    LinkedIn LinkedIn Icon

    1. Go to LinkedIn Developers website;
    2. Sign in to your account;
    3. Click the Create application button;
    4. Fill out all the fields marked with the red sign and click the Submit button;
    5. Check the r_basicprofile and r_emailaddress options in the Default Application Permissions section;
    6. Introduce "https://service.onlyoffice.com/oauth2.aspx" in the Authorized redirect URLs field, click the Add button, then click Update at the bottom of the page to save the changes;
    7. Copy or write down the Client ID and Client Secret in the Authentication Keys section.

    OneDrive OneDrive Icon

    1. Go to Live Connect Developer Center;
    2. Sign in to your account;
    3. Introduce your application name;
    4. Click the Create application button;
    5. Go to the Platforms section;
    6. Click the Add URL button next to the Redirect URLs caption. Enter "https://service.onlyoffice.com/oauth2.aspx" in the field that appears;
    7. Click the Save button at the bottom of the page;
    8. Copy or write down Application Id in the Properties section and Application Secret in the Application Secrets section below.

    smsc smsc Icon

    1. Use your smsc account login;
    2. Use your password or password MD5 hash in lower case. To generate MD5 hash you can use the following link.

    Twilio Twilio Icon

    1. Go to Twilio Console;
    2. Sign in to your account;
    3. Copy or write down the ACCOUNT SID and AUTH TOKEN located in the Project Info section of the Account Dashboard;
    4. Go to the Phone Numbers section;
    5. Copy the phone number that is required for the two-factor authentication.

    Twitter Twitter Icon

    1. Go to Twitter Developers Portal;
    2. Sign in to your account;
    3. Complete the Create an application form. Fill out the Name, Description and Website fields;
    4. In the Callback URL field introduce "https://service.onlyoffice.com/oauth2.aspx";
    5. Accept the Developer Agreement;
    6. Click the Create your Twitter application button;
    7. Go to Keys and Access Tokens section;
    8. Copy or write down the Consumer Key (API Key) and Consumer Secret (API Secret);
    9. Click the Create my access token button in the Your Access Token section;
    10. Copy or write down the Access Token and Access Token Secret for searching for contacts in the CRM module.

    Wordpress Wordpress Icon

    1. Sign in to your Wordpress account. If you have not yet registered, go to the Wordpress signup page and fill in the registration form to create a new account. A new free website will be created together with your account;
    2. When you are signed in, go to the Wordpress Developers page;
    3. Fill in all the required fields to create a new application: specify your application Name, Description, Website URL;
    4. In the Redirect URLs field, introduce "https://service.onlyoffice.com/oauth2.aspx";
    5. Answer the verification question (e.g. 'What is 6 + 2?') and click the Create button;
    6. You will be redirected to the Manage Settings page. Click on your application name to display your application information;
    7. In the OAuth Information section, copy or write down the Client ID and Client Secret.

    Yahoo Yahoo Icon

    1. Sign in to your Yahoo account;
    2. Go to the Create Application page in the Yahoo Developer Network;
    3. Specify the Application Name;
    4. In the Callback Domain field, introduce "https://service.onlyoffice.com";
    5. In the API Permissions section, check the Contacts option;
    6. Click the Create App button;
    7. Copy or write down the Client ID and Client Secret.
  4. To connect the necessary service click on the switcher next to it. A new window will open.
  5. Introduce your received application ID and Key to the appropriate third party fields.

  6. Click the Enable button.

That's it! Now you can enjoy all the benefits of the Authorization keys option.

Helpful Hints

How to connect my Facebook/Google/LinkedIn/Twitter account to portal?

When you proceed through all the steps described in the instruction, go to your 'Profile' page clicking the link with your name in the right upper corner of the page and choosing the corresponding option. On your 'Profile' page find the 'Login via Social Networks' caption, choose the necessary service and click the 'Connect' button. In the opened window grant the access to ONLYOFFICE application and introduce the account credentials, if it's necessary.

How to synchronize my Box/Dropbox/Google/OneDrive with the Documents module?

You can easily synchronize your Box/Dropbox/Google/OneDrive account with the 'Documents' module of your portal just within a few minutes. Read this article to learn more.

How to send documents for signing right from the Documents module using the DocuSign service?

Once you perform all the steps described above, go to the 'Documents' module and connect your DocuSign account following these instructions.

Depending on which environment you use (DocuSign Sandbox or Production account), other portal users who want to be able to send their documents for signature should also use corresponding accounts:

  • https://account-d.docusign.com - if you use a sandbox.
  • https://account.docusign.com - if you use a production account.

For further instructions on how to send documents for signature you can refer to this article.

How to call my CRM contacts right from a web browser using the Twilio service?

After the completion of the above-mentioned actions, please refer to the following article to learn more on how to use the VoIP functionality.

How to enable the two-factor authentication using the Clickatell, Twilio, or smsc service?

Once you connect the Clickatell, Twilio, or smsc service to your portal as described above, you can read the following article to learn more on how to enable the two-factor authentication on your portal.

How to connect ONLYOFFICE with Facebook
Close
How to connect ONLYOFFICE with Twitter
Close
How to connect ONLYOFFICE with Google
Close
How to connect ONLYOFFICE with LinkedIn
Close
How to connect ONLYOFFICE with DropBox
Close
How to connect ONLYOFFICE with OneDrive
Close
How to connect ONLYOFFICE with Box
Close
Download Host on your own server Available for Docker,
Windows, Linux and virtual machines
You Might Also Like This:
Close