How It Works
MySQL access in Infisical PAM uses an Infisical Gateway to securely proxy connections to your MySQL server. When a user requests access, Infisical establishes a secure tunnel through the Gateway, enabling secure access without exposing your MySQL instance directly.Key Concepts
- Gateway: An Infisical Gateway deployed in your network that can reach the MySQL server. The Gateway handles secure communication between users and your MySQL instance.
- Authentication: Credentials (username/password) are stored securely in Infisical and used by the Gateway to authenticate with MySQL on behalf of the user.
- Local Proxy: The Infisical CLI starts a local proxy on your machine that intercepts MySQL connections and routes them securely through the Gateway to your MySQL instance.
- Session Tracking: All access sessions are logged, including when the session was created, who accessed the MySQL instance, session duration, and when it ended.
Session Tracking
Infisical tracks:- When the session was created
- Who accessed which MySQL instance
- Session duration
- When the session ended
Session Logs: After ending a session (by stopping the proxy), you can view
detailed session logs in the Sessions page.
Prerequisites
Before configuring MySQL access in Infisical PAM, you need:- Infisical Gateway - A Gateway deployed in your network with access to the MySQL server
- MySQL Credentials - Username and password for the MySQL instance
- Infisical CLI - The Infisical CLI installed on user machines
Create the PAM Resource
The PAM Resource represents the connection between Infisical and your MySQL instance.Ensure Gateway is Running
Before creating the resource, ensure you have an Infisical Gateway running and registered with your Infisical instance. The Gateway must have network access to your MySQL server.
Create the Resource in Infisical
- Navigate to your PAM project and go to the Resources tab
- Click Add Resource and select MySQL
- Enter a Name for the resource (e.g.,
production-mysql,staging-db) - Select the Gateway that has access to this MySQL instance
- Enter the Host - the hostname or IP address of your MySQL server (e.g.,
mysql.example.comor192.168.1.100) - Optionally enter the Database Name to connect to a specific database
- Enter the Port - the MySQL port (default:
3306) - Configure SSL/TLS options:
- Enable SSL: Toggle to enable TLS/SSL connections (enabled by default)
- Reject Unauthorized: Toggle to verify SSL certificates (enabled by default, recommended for production)
- Trusted CA SSL Certificate: Optional CA certificate for custom certificate authorities
SSL Configuration: SSL is enabled by default. For self-signed certificates, you may need to provide the CA certificate or disable certificate validation (not recommended for production).
Create PAM Accounts
Once you have configured the PAM resource, you’ll need to configure a PAM account for your MySQL resource. A PAM Account represents a specific set of credentials that users can request access to. You can create multiple accounts per resource, each with different permission levels.Navigate to Resource
Go to the Resources tab in your PAM project and open the MySQL resource you created.
Fill in Account Details
Fill in the account details:
A friendly name for this account (e.g.,
readonly-user, admin-access)An optional description for this account.
The MySQL username.
The MySQL password.
When enabled, users must complete a multi-factor authentication (MFA) challenge before accessing this account. The MFA method used is determined by the organization’s enforced method, the user’s configured method, or email as a fallback.
Access MySQL Account
Once your resource and accounts are configured, users can request access through the Infisical CLI:Get the Access Command
- Navigate to the Resources tab in your PAM project and open the MySQL resource
- In the resource’s accounts section, find the account you want to access
- Click the Access button for that account
- Copy the provided CLI command
Run the Access Command
Run the copied command in your terminal.The CLI will:
- Authenticate with Infisical
- Establish a secure connection through the Gateway
- Start a local proxy on your machine
- Display a local connection URL you can use to connect
Connect to MySQL
Once the proxy is running, connect to MySQL using the connection details displayed by the CLI. You can use any MySQL client — no password is needed, as the Gateway injects the real credentials on your behalf.Using mysql CLI:Using other clients:You can also use GUI clients such as MySQL Workbench, DBeaver, DataGrip, TablePlus, or Sequel Pro. Point them to
127.0.0.1 on the port shown in the CLI output with the username and database from the connection details. Leave the password field empty.