Thanks to visit codestin.com
Credit goes to github.com

Skip to content

docs: refresh JFrog Artifactory integration guide for SaaS #28005

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
matifali merged 5 commits into from
Aug 10, 2026
Merged

docs: refresh JFrog Artifactory integration guide for SaaS #28005

Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
46d90a5
docs: clarify JFrog OAuth setup for SaaS and self-hosted Artifactory
matifali Aug 10, 2026
45bbb7b
docs: update JFrog-Token module source path and version
matifali Aug 10, 2026
8913057
docs: relax JFrog module version constraints to ~> 1.0
matifali Aug 10, 2026
b9e90bc
docs: address review, use select for UI and one sentence per line
matifali Aug 10, 2026
56093f8
docs: apply review suggestions for JFrog OAuth setup steps
matifali Aug 10, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
34 changes: 21 additions & 13 deletions docs/admin/integrations/jfrog-artifactory.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -25,12 +25,24 @@ two type of modules that automate the JFrog Artifactory and Coder integration.

### JFrog-OAuth

This module is usable by JFrog self-hosted (on-premises) Artifactory as it
requires configuring a custom integration. This integration benefits from Coder's [external-auth](../external-auth/index.md) feature allows each user to authenticate with Artifactory using an OAuth flow and issues user-scoped tokens to each user.
This module works with both JFrog SaaS (for example, `example.jfrog.io`) and self-hosted (on-premises) Artifactory.
It uses Coder's [external-auth](../external-auth/index.md) feature, so each user authenticates with Artifactory through an OAuth flow, and Coder issues a user-scoped access token to each workspace.

To set this up, follow these steps:

1. Add the following to your Helm chart `values.yaml` for JFrog Artifactory. Replace `CODER_URL` with your JFrog Artifactory base URL:
1. Create an application integration in Artifactory.
Use `https://<CODER_URL>/external-auth/jfrog/callback` (your Coder deployment URL) as the callback URL and `applied-permissions/user` as the scope.

**JFrog SaaS** (`example.jfrog.io`): Create the integration from the JFrog Platform UI as an administrator:

1. Go to **Administration** > **General Management** > **Manage Integrations**, or open `https://<JFROG_URL>/ui/admin/configuration/integrations/application` directly.
1. Select **New Integration**.
1. Select **External Applications**.
1. On the **Create New Application Integration** form, set **Application Name** to `Coder`, set **Application Type** to **Custom Integration**, and enter the callback URL.
1. Select **Generate Client ID & Secret**.

**Self-hosted (on-premises)**: First register an integration template in your Helm chart `values.yaml`, then create the application integration in the UI, and select that template as the **Application Type**.
Replace `CODER_URL` with your Coder deployment URL:

```yaml
artifactory:
Expand All @@ -49,12 +61,8 @@ To set this up, follow these steps:
scope: "applied-permissions/user"
```

1. Create a new Application Integration by going to
`https://JFROG_URL/ui/admin/configuration/integrations/app-integrations/new` and select the
Application Type as the integration you created in step 1 or `Custom Integration` if you are using SaaS instance i.e. example.jfrog.io.

1. Add a new [external authentication](../external-auth/index.md) to Coder by setting these
environment variables in a manner consistent with your Coder deployment. Replace `JFROG_URL` with your JFrog Artifactory base URL:
1. Add a new [external authentication](../external-auth/index.md) to Coder by setting these environment variables in a manner consistent with your Coder deployment.
Replace `JFROG_URL` with your JFrog Artifactory base URL, and the client ID and secret with the values from step 1:

```dotenv
# JFrog Artifactory External Auth
Expand All @@ -73,8 +81,8 @@ To set this up, follow these steps:
```tf
module "jfrog" {
count = data.coder_workspace.me.start_count
source = "registry.coder.com/modules/jfrog-oauth/coder"
version = "1.0.19"
source = "registry.coder.com/coder/jfrog-oauth/coder"
version = "~> 1.0"
agent_id = coder_agent.example.id
jfrog_url = "https://example.jfrog.io"
username_field = "username" # If you are using GitHub to login to both Coder and Artifactory, use username_field = "username"
Expand Down Expand Up @@ -109,8 +117,8 @@ To set this up, follow these steps:
}

module "jfrog" {
source = "registry.coder.com/modules/jfrog-token/coder"
version = "1.0.30"
source = "registry.coder.com/coder/jfrog-token/coder"
version = "~> 1.0"
agent_id = coder_agent.example.id
jfrog_url = "https://XXXX.jfrog.io"
artifactory_access_token = var.artifactory_access_token
Expand Down
Loading