User settings

As a user in Codefresh, you can manage the access tokens defined in your account, and optionally, enable access for Codefresh support.

  • Enable access for Codefresh support

    Optional. Enable access to your account for troubleshooting purposes.

  • Manage Git tokens for authentication

    The Git personal token is a user-specific access token per provisioned runtime, and is required to authenticate Git-based actions per runtime in Codefresh.
    If your admin has set up authentication with OAuth2, you can authorize access to GitHub using OAuth2.
    Or, you can always generate a personal access token from GitHub and then add the same to Codefresh to authorize access.

Enable access for Codefresh support

Enable Codefresh support personnel to access your user account. Access to your account is useful for visibility during troubleshooting.

You can disable this security setting at any time.

Codefresh personnel takes action only after confirmation from you, and all actions are audited.

  1. In the CSDP UI, go to User Settings.
  2. Enable Allow Codefresh support tem to log in….

Enable access for Codefresh support

Enable access for Codefresh support

Update/delete Git personal access tokens

Update your Git personal access token for hosted and hybrid runtimes when needed from the User Settings page.
To authorize with OAuth2, you have to supply your credentials. When authorized, you are automatically directed to the Git Personal Tokens page.

  • For OAuth2, the permissions and expiry date are pre-configured by the administrator.
  • For Git personal access tokens, when generating a new token, make sure you select repo scope for commits and other actions.

If you need access to more than one runtime, you can use the same token for multiple runtimes. You must however authorize GitHub access or add the personal access token individually for each runtime.

Permissions for Git personal token

Permissions for Git personal token

To authorize with OAuth2, you have to supply your credentials. When authorized, you are automatically directed to the Git Personal Tokens page.

Before you begin

  • To use a Git PAT, generate a valid personal access token from your Git provider

How to

  1. In the CSDP UI, go to User Settings.
  2. Select the runtime, and then select one of the following:
    • To add a token, select Add Token.
    • To update an existing token by replacing it with a new token, select Update Token.
    • To delete an existing token, select Delete Token.
  3. For OAuth2:
    • In the Add Token panel, click Authorize Access to GitHub.

      If the application is not registered, you get an error. For example, Git app not registered. Contact your admin for help.

    • Enter your credentials, and select Sign In.
    • Complete the verification, for example, if you two-factor authentication is configured.

Authorizing access with OAuth2

Authorizing access with OAuth2
  1. For Git personal access tokens:
    Paste the generated token in the Token field, and select +Add Token.

Adding a Git personal access token

Adding a Git personal access token

The token is generated and you are redirected to the User Settings page where you can see the new Git token assigned to the runtime.

Git tokens in Codefresh