Using stateless authentication with existing users

If you want to start using stateless authentication on a server that already has your users set up, you can export your users, then set up stateless authentication, and finally import your users back to your server. This avoids having to set up your users again from scratch.

You must export your existing users before configuring stateless authentication as explained in Configuring stateless authentication. Then, import your users after configuring stateless authentication.

Note

You can also export and import your users from another Matillion ETL server using the migration tool, which you can find by clicking Admin and then clicking Migrate.

---

Export your existing users

To export your existing users before setting up stateless authentication on your server:

1. SSH into your Matillion ETL instance.

2. Export your users with the following API command:

   curl -o users.json -X GET -u <apiuser>:<apipassword> -k "https://localhost:8443/rest/v1/userconfig/export" -H "Content-Type: application/json"
   

Now configure stateless authentication by following the relevant guide linked in Configuring stateless authentication. After you have finished configuring stateless authentication, return to this guide to import your users.

---

Import your existing users

To import your existing users after setting up stateless authentication on your server:

1. SSH into your Matillion ETL instance.

2. Import your users with the following API command:

   curl -X POST -u <apiuser>:<apipassword> -k "https://localhost:8443/rest/v1/userconfig/import" -H "Content-Type: application/json" --data-binary @users.json`.
   

You can now use stateless authentication using your existing users.