Introduction

A pipeline fails with the following error: 

API key and personal access token (PAT) of the user triggering the pipeline has not been setup. The user designing or triggering a pipeline must have these user settings defined. Go to the Settings tab under Pipelines to do so and run the pipeline again.

This article explains the causes of pipeline failures and how to fix the local configuration settings.

Environment

Applications hosted in Mendix Cloud

Instructions/Procedure

There are two possible causes for this issue. After identifying the correct scenario, proceed with the relevant steps to fix it. 

• Check if the account used to configure the pipeline and commit the changes is the same. 
  1. This is because if a pipeline is configured to trigger on a commit, then it will trigger on any commit of any team member. But, from a security perspective, the pipeline will always be run within the security context of the user that triggered it. 
  2. In large teams, different people design pipelines, activate them, make commits, or trigger runs. Running the pipeline on behalf of the committing user improves transparency and ensures proper access control.
     It was designed in this way to avoid for example a person without deploy rights for an environment, to make a commit on a branch that triggers a deployment to the environment.
• If the user committing changes and configuring pipelines are indeed the same and the error persists, fix the local configuration by executing this following commands: 

  1. Check local configuration by navigating to the project folder and executing the following command in the terminal:

     git config get user.email

  2. If the above command does not show the email address, execute the following command in the same terminal to fix the local configuration::

     git config --global user.email <Email>

Outcome

The pipeline runs smoothly without errors.

Additional information

• Mendix documentation: Troubleshooting Version Control
• Other documentation:
  • Override user.name and user.email used in git
  • Why are my commits linked to the wrong user?