Connect your sites to DEC

You connect each Sitefinity CMS instance separately and to a specific data center. If you are working in multisite mode, you can choose a specific data center to track each of the sites. That is, to track the sites separately.

PREREQUISITES: Your user needs to have access to all data centers and permissions to manage data centers within the account in order to establish connection and generate access keys.

Access keys

To secure the connection between Sitefinity CMS and data centers, DEC uses access keys as authentication mechanism. Each access key is a JSON Web token, which uniquely identifies each connection to Sitefinity CMS, or any specific site or instance. An access key expires only after you deactivate it manually.

Generate access keys

Access keys are generated in the DEC Administration dashboard and, upon configuring your DEC connector in Sitefinity CMS, you use them to establish the connection.

To generate an access key:

  1. Open the DEC Administration dashboard and click Access keys.
  2. Click Generate access key.
  3. Enter a name that will help you identify the key in the list with other keys, for example, Product site.
  4. Define the level of access this key will grant upon connection to Sitefinity CMS:
    • All data centers
      This connection has access to all existing and newly created data centers, that is, all sites within this Sitefinity CMS instance.  
    • Selected data centers
      The connection gives a selected list of data centers to track.

      NOTE: You can later modify the permissions. When creating a new data center, make sure modify the list with selected data centers accordingly, so that you grant access to the new data center.

  5. Click Generate.
  6. Copy the generated key.

    IMPORTANT: Once you close the window, you will not be able to see this key again. Make sure you have a copy of the key in a secure place.

Manage access keys

Navigate to the Administration dashboard » Access keys to see a list of all generated keys, as well as details about the access they grant and when were the keys generated.

By clicking on the cog icon, you can also:

  • Deactivate key
    Connection to Sitefinity CMS is lost and your sites will no longer be tracked.
  • Change access
    Change the level of permission for this connection.

You can also sort the key list to display either all activated or deactivated keys.

NOTE: When you creating new data centers, do not forget to update the access key permissions, so that access is granted to the newly created data centers. If you already granted access to all data centers, you do not have to change anything. 

Use access keys in Sitefinity CMS

You can now use this key to connect Sitefinity CMS to DEC. For more information, see Connect to DEC.

IMPORTANT: Depending on the Sitefinity CMS version you are working with, you use the access key in a slightly different way:

  • Sitefinity CMS 12.1
    In Access key field, paste the access key.
  • Sitefinity 12.0 and older
    In Password field, paste the access key.
    In Username/Email field, enter AccessKey 

    IMPORTANT: If you are working with Sitefinity CMS 8.0 or older, you cannot set up the DEC with the access key. For more information, contact sitefinitysales@progress.com

 

Was this article helpful?