Skip to main content
Version: 8.1On-site

Update the Identity Service using IIS

Update the Identity Service when you update the on-site Creatio instance. The Identity Service archive is provided with the Creatio install file. Before you update the Identity Service on the Creatio application server, update the Creatio instance. Instructions: Update guide.

To update the Identity Service using IIS:

  1. Install additional components.

    .NET 6 Runtime. Download the install file

    .NET 6 Hosting Bundle. Download the install file

  2. Restart the IIS.

  3. Back up the files of the root Identity Service directory to an arbitrary place.

  4. Back up the database connected to the current version of Identity Service. Instructions: Creating database backup.

  5. Stop the application pool of the Identity Service in the IIS.

  6. Stop the website of the Identity Service in the IIS.

  7. Extract the IdentityService.zip archive to the Creatio install file directory.

  8. Replace the files in the root Identity Service directory with the unpacked files.

  9. Reconfigure the Identity Service using IIS. Instructions: Install the Identity Service using IIS (steps 7-11).

  10. Start the application pool of the Identity Service in the IIS.

  11. Start the website of the Identity Service in the IIS.

  12. Test the Identity Service. To do this, access the [Identity Service URL]/.well-known/openid-configuration URL from the browser.

    If the Identity Service is not working as expected, restore the previous version of the Identity Service. Read more >>>

As a result, the Identity Service will be updated.

If an error occurs during the updating, restore the previous version and try again.

To restore the previous version of the Identity Service:

  1. Restore the files from the Identity Service backup.
  2. Restore the database from the backup.
  3. Restart the application pool of the Identity Service in the IIS.
  4. Restart the website of the Identity Service in the IIS.
  5. Test the Identity Service. To do this, access the [Identity Service URL]/.well-known/openid-configuration URL from the browser.

If the Identity service is not working, contact Creatio support.

You can set up automated monitoring systems based on OAuth health monitoring. Instructions: OAuth health monitoring. If needed, use Postman to check the health of OAuth functionality. The Postman request collection that tests requests is available in Creatio API documentation.

See also​

Deploy the Identity Service

Connect the Identity Service to Creatio

Generate OAuth 2.0 client credentials

Authorize external requests using OAuth 2.0 (developer documentation)

E-learning courses​

Tech Hour - Integrate like a boss with Creatio, part 2 (Odata)