Connect Contribute to an Author-it library

Author-it Modules Installation & Update Guide

To use Contribute, you must select the Author-it libraries your contributors will access via Contribute, then connect Contribute to those libraries.

  1. Connect InternalAPI to an Author-it library.

    InternalAPI is a critical component of Contribute, Review, or Localize. To use these applications, you must connect InternalAPI to the Author-it libraries that you want to use the applications with.

    1. On your web applications server, go to C:\inetpub\wwwroot\internalapi

    2. Open ApiServer.config

    3. In the <Libraries> section, add a new line for each library you want to connect InternalAPI to. Use the commented examples as a guide for the required information.

      There are two ways of connecting to the SQL Server: “trusted” or “fixed”:

      • A trusted connection means that the user for the Application Pool Identity logs in to the SQL Server. For this type of connection, “Windows Authentication” must be enabled on the SQL Server, and the Application Pool Identity User must be allowed full control over the selected database.

        Example for a trusted connection:

        <Library Alias="SampleTrusted1" Type="SqlServer" Server=".\SQLEXPRESS" Database="SampleTrusted1" TrustedConnection="True" />

      • When using a fixed SQL Server login, there must be a dedicated user-login on the SQL Server that has full access to the selected database. The username and password of this SQL Server user must be specified in the connection settings.

        Example using a fixed SQL Server login:

        <Library Alias="SampleFixed2" Type="SqlServer" Server=".\SQLEXPRESS" Database="SampleFixed2" TrustedConnection="False" LoginID="SqlUser" Password="SqlPassword" />

      In which:

      Library Alias: is the name of the library to be used. This should also match the database name.

      Type: should be “SqlServer”

      Server: network name or ip address of the SQL Server

      Database: name of the library on the SQL Server

      TrustedConnection:

      True” if you are using the Application Pool Identity User to log into SQL-Server using Windows authentication.

      False” if you want to use a fixed SQL Server login such as ait to connect to the database.

      LoginID: Name for the fixed SQL Server login.

      Password: password for the fixed SQL Server login.

    4. Save.

    Note all of the library aliases you add to ApiServer.config

  2. On your web applications server, go to C:\inetpub\wwwroot\Contribute

  3. Open Library.config

  4. Add your library aliases to the appSettings section. Separate multiple values with commas:

    <add key="InternalAPI.Libraries" value=" LibraryAlias1, LibraryAlias2" />

  5. Open Web.config

  6. Locate the <appSettings file="Library.config"> section.

  7. Make sure the value of ServicesAPI.Url is {Name of the IIS Application pool for AuthoritWebAPIService}/api. For example:

    <add key="ServicesAPI.Url" value="AuthoritWebAPIService/api/" />

  8. Change the value of Feedback Email:

    <add key="Feedback.Email " value="KC_feedback@Author-it.com" />