Skip to content

Commit e72476e

Browse files
ThomasK33ThomasK33
committed
feat(oauth2): implement RFC 9728 Protected Resource Metadata endpoint
- Add OAuth2ProtectedResourceMetadata struct in codersdk/oauth2.go - Implement /.well-known/oauth-protected-resource endpoint handler - Register route in coderd.go for Protected Resource Metadata discovery - Add comprehensive test coverage in oauth2_metadata_test.go - Update OpenAPI documentation and generated API types - Correctly omit bearer_methods_supported field (Coder uses custom auth) - Support MCP OAuth2 compliance requirement for resource server metadata This implements RFC 9728 OAuth 2.0 Protected Resource Metadata to enable MCP clients to discover resource server capabilities and authorization servers. Change-Id: I089232ae755acf13eb0a7be46944c9eeaaafb75b Signed-off-by: Thomas Kosiewski <tk@coder.com>
1 parent d2eb876 commit e72476e

File tree

10 files changed

+223
-0
lines changed

10 files changed

+223
-0
lines changed

‎coderd/apidoc/docs.go

Lines changed: 46 additions & 0 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

‎coderd/apidoc/swagger.json

Lines changed: 42 additions & 0 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

‎coderd/coderd.go

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -914,6 +914,8 @@ func New(options *Options) *API {
914914

915915
// OAuth2 metadata endpoint for RFC 8414 discovery
916916
r.Get("/.well-known/oauth-authorization-server", api.oauth2AuthorizationServerMetadata)
917+
// OAuth2 protected resource metadata endpoint for RFC 9728 discovery
918+
r.Get("/.well-known/oauth-protected-resource", api.oauth2ProtectedResourceMetadata)
917919

918920
// OAuth2 linking routes do not make sense under the /api/v2 path. These are
919921
// for an external application to use Coder as an OAuth2 provider, not for

‎coderd/httpmw/apikey.go

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -625,6 +625,8 @@ func APITokenFromRequest(r *http.Request) string {
625625
return headerValue
626626
}
627627

628+
// TODO(ThomasK33): Implement RFC 6750
629+
628630
return ""
629631
}
630632

‎coderd/oauth2.go

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -417,3 +417,23 @@ func (api *API) oauth2AuthorizationServerMetadata(rw http.ResponseWriter, r *htt
417417
}
418418
httpapi.Write(ctx, rw, http.StatusOK, metadata)
419419
}
420+
421+
// @Summary OAuth2 protected resource metadata.
422+
// @ID oauth2-protected-resource-metadata
423+
// @Produce json
424+
// @Tags Enterprise
425+
// @Success 200 {object} codersdk.OAuth2ProtectedResourceMetadata
426+
// @Router /.well-known/oauth-protected-resource [get]
427+
func (api *API) oauth2ProtectedResourceMetadata(rw http.ResponseWriter, r *http.Request) {
428+
ctx := r.Context()
429+
metadata := codersdk.OAuth2ProtectedResourceMetadata{
430+
Resource: api.AccessURL.String(),
431+
AuthorizationServers: []string{api.AccessURL.String()},
432+
// TODO: Implement scope system based on RBAC permissions
433+
ScopesSupported: []string{},
434+
// Note: Coder uses custom authentication methods, not RFC 6750 bearer tokens
435+
// TODO(ThomasK33): Implement RFC 6750
436+
// BearerMethodsSupported: []string{}, // Omitted - no standard bearer token support
437+
}
438+
httpapi.Write(ctx, rw, http.StatusOK, metadata)
439+
}

‎coderd/oauth2_metadata_test.go

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -41,3 +41,35 @@ func TestOAuth2AuthorizationServerMetadata(t *testing.T) {
4141
require.Contains(t, metadata.GrantTypesSupported, "refresh_token")
4242
require.Contains(t, metadata.CodeChallengeMethodsSupported, "S256")
4343
}
44+
45+
func TestOAuth2ProtectedResourceMetadata(t *testing.T) {
46+
t.Parallel()
47+
48+
client := coderdtest.New(t, nil)
49+
50+
ctx, cancel := context.WithTimeout(context.Background(), testutil.WaitLong)
51+
defer cancel()
52+
53+
// Get the protected resource metadata
54+
resp, err := client.Request(ctx, http.MethodGet, "/.well-known/oauth-protected-resource", nil)
55+
require.NoError(t, err)
56+
defer resp.Body.Close()
57+
58+
require.Equal(t, http.StatusOK, resp.StatusCode)
59+
60+
var metadata codersdk.OAuth2ProtectedResourceMetadata
61+
err = json.NewDecoder(resp.Body).Decode(&metadata)
62+
require.NoError(t, err)
63+
64+
// Verify the metadata
65+
require.NotEmpty(t, metadata.Resource)
66+
require.NotEmpty(t, metadata.AuthorizationServers)
67+
require.Len(t, metadata.AuthorizationServers, 1)
68+
require.Equal(t, metadata.Resource, metadata.AuthorizationServers[0])
69+
// BearerMethodsSupported is omitted since Coder uses custom authentication methods
70+
// Standard RFC 6750 bearer tokens are not supported
71+
require.True(t, len(metadata.BearerMethodsSupported) == 0)
72+
// ScopesSupported can be empty until scope system is implemented
73+
// Empty slice is marshaled as empty array, but can be nil when unmarshaled
74+
require.True(t, len(metadata.ScopesSupported) == 0)
75+
}

‎codersdk/oauth2.go

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -244,3 +244,11 @@ type OAuth2AuthorizationServerMetadata struct {
244244
ScopesSupported []string `json:"scopes_supported,omitempty"`
245245
TokenEndpointAuthMethodsSupported []string `json:"token_endpoint_auth_methods_supported,omitempty"`
246246
}
247+
248+
// OAuth2ProtectedResourceMetadata represents RFC 9728 OAuth 2.0 Protected Resource Metadata
249+
type OAuth2ProtectedResourceMetadata struct {
250+
Resource string `json:"resource"`
251+
AuthorizationServers []string `json:"authorization_servers"`
252+
ScopesSupported []string `json:"scopes_supported,omitempty"`
253+
BearerMethodsSupported []string `json:"bearer_methods_supported,omitempty"`
254+
}

‎docs/reference/api/enterprise.md

Lines changed: 37 additions & 0 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

‎docs/reference/api/schemas.md

Lines changed: 26 additions & 0 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

‎site/src/api/typesGenerated.ts

Lines changed: 8 additions & 0 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

0 commit comments

Comments
 (0)