Integrating with our MIM IDP involves running a dedicated client application on your machine. This client interacts with the MIM IDP, facilitates management of the workload's identity, and exposes the workload to locally-running processes. This guide describes how to configure a MIM client if you'd like to run multiple client instances on the same machine.
See the Quickstart for how to download and use the client for workload authentication.
The MIM client persists its identity and other state in a local folder, located at ~/.tsmim. By running a client with a different base directory (i.e., folder), the client assumes a different identity in the target MIM IDP. When running multiple clients, each client must use a different base directory which is set by the --dir=/path/to/folder CLI argument.
The MIM client only listens to local API calls on the machine. By default, the listening port is 3013. The client will not run if the port is already open, either by another instance of the MIM client or by any other process. When running multiple clients, each client must use a different port which is set by the --local-port=1234 CLI argument.
The following command can be used to run a client for the first time with a specific base directory and port:
$ MIM_OPERATOR_BASE=https://<your-mim-host>/operator ./tsmim run --invite-code <ticket ID> --dir <path to folder> --local-port <port>