All pages
Powered by GitBook
1 of 12

Automator

Automator Version 17.0.0

Released on Feb 12, 2025

Overview

Version 17.0.0 features the following improvements and fixes below:

  • KAA-78: Support for RSA to EC migration

  • KAA-80: Automator will enforce EC-only restrictions as directed by the backend

  • KAA-45: Upgrade BouncyCastle library to FIPS version

  • KAA-97: Upgraded Jetty to v12

Update Instructions

  • For container deployments, simply update the container and restart the service

  • For other deployment methods, see the Automator documentation to update

Advanced Features

See this page for all of the new and advanced features / settings for the Automator service.

Automator Version 3.2.1

Released on Mar 18, 2024

Overview

Version 3.2.1 features the following improvements and fixes below:

  • KAA-88: Update dependent libraries

  • KAA-93: RSA public-private key format fix to prevent team approval failure via Automator

  • KAA-89: Enable HTTPS correctly when SSL_CERTIFICATE environment variable is used

  • KAA-85: Increase rate limit on health check

  • KAA-94: Fix restore configuration from Keeper Cloud during Automator restarts

Update Instructions

  • For container deployments, simply update the container and restart the service

  • For other deployment methods, see the Automator documentation to update

Advanced Features

See this page for all of the new and advanced features / settings for the Automator service.

Automator Version 3.2

Released on Dec 8, 2023

Overview

Version 3.2 incorporates Team approvals on top of the 3.1 capabilities. In summary, version 3.2 incorporates the below new features:

  • Team Approval and Creation (new for 3.2)

  • Team User Approvals

  • All settings can be configured as environment variables

  • Support for simplified Azure Container App deployment

  • Support for simplified AWS ECS Service deployment

  • HSTS is enabled for improved HTTPS security

  • IP address filtering for device approval and team approval

  • Optional rate limiting for all APIs

  • Optional filtering by email domain

Team Approval and Team User Approvals

Teams that are provisioned through SCIM can be immediately processed by the Automator service (instead of waiting for the admin to login to the console).

To activate this new feature:

  • Update your Automator container to the latest version

  • Use the automator edit command in Keeper Commander to instruct the service to perform team and team user approvals:

automator edit --skill=team --skill=team_for_user --skill=device "My Automator"
automator setup "My Automator"
automator init "My Automator"
automator enable "My Automator"

All settings can be configured as environment variables

This makes configuration easier when installing Automator in Azure Containers or other Docker-like containers where access to the settings file is difficult.

In Docker, Azure Containers, or other environments that use the docker-compose.yml file, you can set environment variables in the docker compose file, for example:

services:
  automator:
    container_name: "az-autodock"
    environment:
      - AUTOMATOR_PORT=8090
      - AUTOMATOR_HOST=10.0.0.4
      - DISABLE_SNI_CHECK=true

After editing the docker-compose.yml file, you will need to rebuild the container if the environment variables have changed. Just restarting the container will not incorporate the changes.

Advanced Features

See this page for all of the new and advanced features / settings for the Automator service.

Automator Version 3.1

Released on November 2, 2023

Overview

Version 3.1 incorporated several new features:

  • Team User Approvals

  • All settings can be configured as environment variables

  • Support for simplified Azure Container App deployment

  • Support for simplified AWS ECS Service deployment

  • HSTS is enabled for improved HTTPS security

  • IP address filtering for device approval and team approval

  • Optional rate limiting for all APIs

  • Optional filtering by email domain

Team User approvals

Version 3.x introduced Team User approvals. This means that users who are provisioned through SCIM and added to teams can be immediately processed by the Automator service (instead of waiting for the admin to login to the console).

To activate this new feature:

  • Update your Automator container to the latest version

  • Use the automator edit command in Keeper Commander to instruct the service to perform device approvals and also perform Team User approvals:

Example:

automator edit --skill=team_for_user --skill=device "My Automator"
automator setup "My Automator"
automator init "My Automator"
automator enable "My Automator"

Team approvals are coming in version 3.2. This current version only performs team user assignments.

All settings can be configured as environment variables

This makes configuration easier when installing Automator in Azure Containers or other Docker-like containers where access to the settings file is difficult.

In Docker, Azure Containers, or other environments that use the docker-compose.yml file, you can set environment variables in the docker compose file, for example:

services:
  automator:
    container_name: "az-autodock"
    environment:
      - AUTOMATOR_PORT=8090
      - AUTOMATOR_HOST=10.0.0.4
      - DISABLE_SNI_CHECK=true

After editing the docker-compose.yml file, you will need to rebuild the container if the environment variables have changed. Just restarting the container will not incorporate the changes.

Advanced Features

See this page for all of the new and advanced features / settings for the Automator service.

Automator Version 2.2.1

Released on December 9, 2022

Bug Fixes

  • KAA-64: Automator fails with invalid_signing_key if there are 2 different signing keys in the Identity Provider metadata

  • KAA-63: Disabling SNI check is not working properly.

Automator Version 2.2.0

Released on Nov 11, 2022

Changes and Improvements

  • KAA-59: The default port listener has been changed to 443 (instead of 8089) for compatibility with Azure Container Service deployment method.

  • KAA-31: Updated Java version to Amazon Corretto 17.0.3.6.1

  • KAA-54: Added support for EC keys in the .pfx file

  • KAA-55: Switched from IVParameterSpec to GCMParameterSpec

Bug Fixes

  • KAA-45: Switching SSL modes is not restarting the service

Automator Version 2.1

Released on August 3, 2022

Overview

Automator Version 2.1 is a major upgrade of the Keeper Automator service.

  • Automatic configuration reload on service restart

  • Docker and Docker Compose install methods

  • New Windows Service installer

  • MSP multi-tenant configuration for Managed Companies

Upgrade from 1.x to 2.1

A direct path to upgrade is not available. Installing a fresh new version of the Automator is the recommended path forward.

Upgrade Instructions:

(1) From Commander, disable the current automator:

My Vault> automator list

... get the ID ...

My Vault> automator disable XXX

(2) Retrieve the ssl-certificate.pfx and ssl-certificate-password.txt files from your current installation of Automator. If no password is set for the certificate, you only need the ssl-certificate.pfx file.

(3) Install a new version of Automator using one of the new installation methods:

https://docs.keeper.io/sso-connect-cloud/device-approvals/automator (4) Run the setup/init/enable commands from Commander:

My Vault> automator setup XXX
My Vault> automator init XXX
My Vault> automator enable XXX

New Features

  • KAA-28: Support approvals for multiple MCs within the same tenant For more information see Multi-Tenant Mode documentation.

  • KAA-41: Support for conditional approvals based on a new SAML response flag DeviceApprovalRequired which can be set to true or false. A value of "true" means that the device needs to be manually approved by the user. A value of "false" means that the device should be automatically approved by the automator service.

Automator Version 1.0.6

Released on Jan 14, 2022

Version 1.0.6 supports Windows Services. To convert an existing Windows cmd-line install to the full Services mode, follow the steps below:

  • Stop the existing service

  • Unzip and Install the new Automator: https://keepersecurity.com/automator/keeper-automator-windows.zip

  • Copy the contents of the old Automator properties/ folder from the old location to C:\ProgramData\Keeper Automator\settings\

  • Open Windows Services

  • Start the Keeper Automator service

  • From Commander, run "automator setup", "automator init" and "automator enable" as normally would be done.

Automator Version 1.0.5

Released on Dec 10, 2021

Automator Version 1.0.5 contains a security update that is recommended for all customers.

Please contact Keeper Enterprise support if you require assistance with the upgrade.

For update instructions, see the below link: https://docs.keeper.io/sso-connect-cloud/device-approvals/automator/updating-the-automator

Automator Version 1.0.4

Released on Dec 3, 2021

Automator Version 1.0.4 contains a security update that is recommended for all customers.

Please contact Keeper Enterprise support if you require assistance with the upgrade.

For update instructions, see the below link: https://docs.keeper.io/sso-connect-cloud/device-approvals/automator/updating-the-automator

Automator Version 1.0.3

Released on Nov 1, 2021

Initial customer release of Keeper Automator