Warning | ||
---|---|---|
| ||
Please note that thethe URL user andand URL password parameters are deprecated and will be removed on March 31, 2022. We recommend usinguser password parameters were removed in 3.8.2 (see Deprecation notice: URL user and URL user password parameters). We recommend using profiles to access yourexternal data from remote locations. |
This article illustrates the process of adding a GitLab profile to the Markdown from a URL macro.
...
Navigate to CONFLUENCE ADMINISTRATION > General Configuration > BOB SWIFT CONFIGURATION > Markdown > Profiles.
Click Add Profile.
Enter a unique profile name in the Profile name text box.
Info Ensure that you provide a unique profile name. If you enter a profile name that already exists, the existing profile gets replaced with the given information.
Select GitLab from the options in Profile type.
Note The Request headers parameter is auto-filled and more information gets appended as other relevant parameters are filled.
Enter the relevant URL for GitLab in the URL text box. Example: https://gitlab.com/api/v4/projects.
Info It is recommended to provide only the base URL in this text box and let the users enter the relevant relative path to the actual file to be rendered through the macro. This method allows multiple users to access a profile across pages and instances of the macros.
Enter User and Password credentials required to access the given URL, or enter the access token for your GitLab profile in the Access token text box. Refer to this personal access token article to know how to create your personal access token.
Note Access tokens or API tokens are a means of user authentication; so, if mentioned, this token is used for authentication instead of using the user credentials. Thus, provide either the user credentials or an access token, but not both.
In this example, an access token is used to connect and access the GitLab repositories.
- Click Save profile to create a profile.