GitLab policy
A GitLab policy contains the connection details that are used by a GitLab Input or GitLab Request node when connecting to a GitLab application.
You can use a GitLab Request node in a message flow to connect IBM® App Connect Enterprise to GitLab applications and issue requests to perform actions on objects such as epics, issues, branches, milestones, pipelines, commits, and merge requests. You can use a GitLab Input node in a message flow to monitor GitLab for changes and accept input. The GitLab policy controls, at run time, access to the GitLab application.
The GitLab policy is created when you configure a
connection between a GitLab Input or a GitLab Request node and GitLab by using the Connector Discovery wizard. During the
process of discovery, account credentials are stored in the vault and connection details are stored
in a GitLab policy. The policy is created with a type of
GitLab, and the name of the policy is returned to the GitLab node and specified in the Connection tab of the node,
in the format {policyProjectName}:policyName.
You can also create, update, or delete a GitLab policy by using the Manage Discovery Connector Policies and Credentials wizard, which you can access by right-clicking the policy project in the IBM App Connect Enterprise Toolkit and then clicking .
You must deploy this policy before message flows that use the policy are started. If you redeploy a GitLab policy, all message flows that are using the policy will be stopped and restarted.
For more information about using GitLab policies, see Using GitLab with IBM App Connect Enterprise.
| Property | Property name in .policyxml file | Description of properties |
|---|---|---|
| Credential Name | credentialName | This property specifies the name of the credential to be used for the
connection to GitLab. The specified credential can be defined during connector discovery and stored in the vault. Alternatively, you can specify an existing credential that was configured by using the mqsicredentials command or the server.conf.yaml file, or loaded through an external credential provider. |
| Endpoint URL | endpointUrl | This property specifies the URL of the GitLab self-managed instance, in the form
https://<hostName>:<port_number>. |
| GitLab Authentication method | authenticationMethod | This property specifies the type of authentication that is used for the
connection between IBM App Connect Enterprise and GitLab. You can set this property to either
BASIC or OAUTH2_PASSWORD. |
| GitLab Application Type | applicationType | This property specifies the type of application and can be set to either
onprem or online. |
| GitLab Application Version | applicationVersion | This property is reserved for future use and must be set to the value
v1. |