Onboarding

Currently, Testing Farm is open for:

  • any Red Hat employee, team or project

  • any Fedora or CentOS Stream contributor, team or SIG

  • any public project, service or initiative which Red Hat, Fedora or CentOS is maintaining or co-maintaining

To be able to use Testing Farm you need an API key. The authentication is expected to change with API version updates, follow the steps according to API version you are using.

The redhat ranch is available only to Red Hat employees, Red Hat teams, or projects that Red Hat is maintaining. Other projects may use the public ranch.

Red Hat ranch users are not allowed to run tests on the redhat ranch from non-Red Hat owned repositories or private repositories which are not forks of Red Hat owned repositories.

An API key always corresponds to a single ranch only. It is not possible to use it for multiple ranches. If you need access to both ranches, you will need two keys.

API version v0.1

With the API version v0.1 the onboarding is a self-service.

We are currently supporting login for:

  • Public ranch users (Fedora, CentOS Stream, open-source projects, etc.) - sign in via Fedora SSO

    For access you need to have a CLA+1 Fedora Account. The CLA+1 means that, in addition to the signed contributor agreement, you should be part of an additional group in the Fedora Account System (either fedora-contributor or testing-farm group).

    If you have problems with the CLA+1, please contact us with the tft@redhat.com email, and we will help you with the onboarding. Please include in the email your Fedora account name.

  • Red Hat employees - sign in via Red Hat SSO

    The Red Hat employees have permissions to create public or redhat ranch tokens.

  • Testing Farm administrators - sign in via GitHub

You can also use the Testing Farm website and click on the Sign in button and sign in with your SSO provider. After that you can go to the Your Tokens and create a new token.

The GitHub login is meant to be only for Testing Farm administrators.

Red Hat SSO Service Account Login

If you need to create team or group level tokens without relying on an individual Red Hat employee’s SSO account, you can use a Red Hat SSO service account to log in to Testing Farm.

  • Request an Internal SSO (auth.redhat.com) Enabled Service Account by following the IT IAM Service Account Guide.

  • Once the service account is provisioned, go to testing-farm.io/tokens and click on the Sign in button.

  • On the sign in page, click Sign in with Red Hat account.

  • Enter the service account username and password.

  • After logging in, create team or group level tokens.

Service account tokens are useful for CI/CD pipelines and shared team infrastructure where tokens should not be tied to an individual user.

We do not provide any other ways of login. If you need to contact us, please see our Contact page.

Regenerating a token

To regenerate a token, the Testing Farm website is the best way to do it. Follow the next steps to regenerate the token:

  • Sign in to the Testing Farm website.

  • You will be redirected to the tokens page. Click on Your Tokens in case you are not redirected.

  • Click on the blue Regenerate button next to the token you want to rotate. This will open a dialog form where you can tweak the expiration date. Once you are satisfied, click Regenerate.

  • Save the API token from the green dialog, this is your new token.