Authentication

Your credentials provide access to proprietary software. Never share your credentials or commit them to public repositories.

Overview

Our system is distributed as a Helm chart and Docker images stored in our private Artifactory repository. You need valid credentials to access these resources during the installation process.

Authentication Methods

We support two authentication methods:

1. Username and Password: Basic authentication with your provided credentials

2. API Token: More secure method using generated tokens with configurable permissions

For production environments, we recommend using API tokens.

Credential Security

Follow these best practices for credential security:

• Use environment variables instead of hardcoding credentials

• Implement secrets management tools like HashiCorp Vault or Kubernetes Secrets

• Rotate credentials regularly

• Use separate credentials for development and production environments

Requesting Access Credentials

New customers should have received initial credentials from our sales team. If you haven't received them, please contact [email protected].

For additional credentials or to replace lost ones:

1. Log in to our Customer Portal

2. Navigate to Account → Access Management

3. Click Request New Credentials

4. Submit the request

Requests are typically processed within 1-2 business days.

Authentication with Helm

Using Username and Password

Command Line

You can provide your credentials directly in the Helm command:

helm repo add maisa-repo https://artifactory.company.com/artifactory/helm-repo \
  --username YOUR_USERNAME \
  --password YOUR_PASSWORD

This method saves your credentials in plain text in your shell history. For better security, use environment variables or the credentials file method.

Environment Variables

Set your credentials as environment variables:

export HELM_REPO_USERNAME=YOUR_USERNAME
export HELM_REPO_PASSWORD=YOUR_PASSWORD

helm repo add maisa-repo https://artifactory.company.com/artifactory/helm-repo

Credentials File

Create a credentials file:

1. Create a file at ~/.helm/credentials.yaml with the following content:

artifactory.company.com:
  username: YOUR_USERNAME
  password: YOUR_PASSWORD

1. Secure the file:

chmod 600 ~/.helm/credentials.yaml

1. Add the repository without explicitly providing credentials:

helm repo add maisa-repo https://artifactory.company.com/artifactory/helm-repo

Helm will automatically use the credentials from the file.

Using API Tokens

API tokens are more secure than username and password authentication.

Use the token in place of a password:

helm repo add maisa-repo https://artifactory.company.com/artifactory/helm-repo \
  --username YOUR_USERNAME \
  --password YOUR_API_TOKEN

Authentication with Docker

The Helm chart needs to pull Docker images from our private registry. You need to configure Docker to authenticate with our registry.

Docker Login

Log in to our Docker registry:

docker login artifactory.company.com \
  --username YOUR_USERNAME \
  --password YOUR_PASSWORD

This command creates or updates the file ~/.docker/config.json with your credentials.

Kubernetes Secret

For Kubernetes to pull images from our private registry, create a secret:

kubectl create secret docker-registry maisa-registry-creds \
  --docker-server=artifactory.company.com \
  --docker-username=YOUR_USERNAME \
  --docker-password=YOUR_PASSWORD \
  --docker-email=YOUR_EMAIL

Then reference this secret in your values.yaml:

imagePullSecrets:
  - name: maisa-registry-creds

Authentication Troubleshooting

Next Steps

Now that you have set up authentication, you can proceed with:

• Installing the Helm chart

• Configuring the system according to your requirements