zitadel/internal/api/scim/integration_test/users_create_test.go

//go:build integration

package integration_test

import (
	"bytes"
	"context"
	_ "embed"
	"fmt"
	"net/http"
	"path"
	"testing"
	"text/template"
	"time"

	"github.com/brianvoe/gofakeit/v6"
	"github.com/stretchr/testify/assert"
	"github.com/stretchr/testify/require"
	"golang.org/x/text/language"
	"google.golang.org/grpc/codes"
	"google.golang.org/grpc/status"

	"github.com/zitadel/zitadel/internal/api/scim/resources"
	"github.com/zitadel/zitadel/internal/api/scim/schemas"
	"github.com/zitadel/zitadel/internal/integration"
	"github.com/zitadel/zitadel/internal/integration/scim"
	"github.com/zitadel/zitadel/internal/test"
	"github.com/zitadel/zitadel/pkg/grpc/management"
	"github.com/zitadel/zitadel/pkg/grpc/user/v2"
)

var (
	//go:embed testdata/users_create_test_minimal.json
	minimalUserJson []byte

	//go:embed testdata/users_create_test_minimal_inactive.json
	minimalInactiveUserJson []byte

	//go:embed testdata/users_create_test_no_primary_email_phone.json
	minimalNoPrimaryEmailPhoneUserJson []byte

	//go:embed testdata/users_create_test_full.json
	fullUserJson []byte

	//go:embed testdata/users_create_test_missing_username.json
	missingUserNameUserJson []byte

	//go:embed testdata/users_create_test_missing_name.json
	missingNameUserJson []byte

	//go:embed testdata/users_create_test_missing_email.json
	missingEmailUserJson []byte

	//go:embed testdata/users_create_test_invalid_password.json
	invalidPasswordUserJson []byte

	//go:embed testdata/users_create_test_invalid_profile_url.json
	invalidProfileUrlUserJson []byte

	//go:embed testdata/users_create_test_invalid_locale.json
	invalidLocaleUserJson []byte

	//go:embed testdata/users_create_test_invalid_timezone.json
	invalidTimeZoneUserJson []byte

	fullUser = &resources.ScimUser{
		ExternalID: "701984",
		UserName:   "bjensen@example.com",
		Name: &resources.ScimUserName{
			Formatted:       "Babs Jensen", // DisplayName takes precedence in Zitadel
			FamilyName:      "Jensen",
			GivenName:       "Barbara",
			MiddleName:      "Jane",
			HonorificPrefix: "Ms.",
			HonorificSuffix: "III",
		},
		DisplayName: "Babs Jensen",
		NickName:    "Babs",
		ProfileUrl:  test.Must(schemas.ParseHTTPURL("http://login.example.com/bjensen")),
		Emails: []*resources.ScimEmail{
			{
				Value:   "bjensen@example.com",
				Primary: true,
			},
		},
		Addresses: []*resources.ScimAddress{
			{
				Type:          "work",
				StreetAddress: "100 Universal City Plaza",
				Locality:      "Hollywood",
				Region:        "CA",
				PostalCode:    "91608",
				Country:       "USA",
				Formatted:     "100 Universal City Plaza\nHollywood, CA 91608 USA",
				Primary:       true,
			},
			{
				Type:          "home",
				StreetAddress: "456 Hollywood Blvd",
				Locality:      "Hollywood",
				Region:        "CA",
				PostalCode:    "91608",
				Country:       "USA",
				Formatted:     "456 Hollywood Blvd\nHollywood, CA 91608 USA",
			},
		},
		PhoneNumbers: []*resources.ScimPhoneNumber{
			{
				Value:   "+415555555555",
				Primary: true,
			},
		},
		Ims: []*resources.ScimIms{
			{
				Value: "someaimhandle",
				Type:  "aim",
			},
			{
				Value: "twitterhandle",
				Type:  "X",
			},
		},
		Photos: []*resources.ScimPhoto{
			{
				Value: *test.Must(schemas.ParseHTTPURL("https://photos.example.com/profilephoto/72930000000Ccne/F")),
				Type:  "photo",
			},
		},
		Roles: []*resources.ScimRole{
			{
				Value:   "my-role-1",
				Display: "Rolle 1",
				Type:    "main-role",
				Primary: true,
			},
			{
				Value:   "my-role-2",
				Display: "Rolle 2",
				Type:    "secondary-role",
				Primary: false,
			},
		},
		Entitlements: []*resources.ScimEntitlement{
			{
				Value:   "my-entitlement-1",
				Display: "Entitlement 1",
				Type:    "main-entitlement",
				Primary: true,
			},
			{
				Value:   "my-entitlement-2",
				Display: "Entitlement 2",
				Type:    "secondary-entitlement",
				Primary: false,
			},
		},
		Title:             "Tour Guide",
		PreferredLanguage: language.MustParse("en-US"),
		Locale:            "en-US",
		Timezone:          "America/Los_Angeles",
		Active:            schemas.NewRelaxedBool(true),
	}
)

func withUsername(fixture []byte, username string) []byte {
	buf := new(bytes.Buffer)
	template.Must(template.New("").Parse(string(fixture))).Execute(buf, &struct {
		Username string
	}{
		Username: username,
	})
	return buf.Bytes()
}

func TestCreateUser(t *testing.T) {
	minimalUsername := gofakeit.Username()
	tests := []struct {
		name          string
		body          []byte
		ctx           context.Context
		orgID         string
		want          *resources.ScimUser
		wantErr       bool
		scimErrorType string
		errorStatus   int
		zitadelErrID  string
	}{
		{
			name: "minimal user",
			body: withUsername(minimalUserJson, minimalUsername),
			want: &resources.ScimUser{
				UserName: minimalUsername,
				Name: &resources.ScimUserName{
					FamilyName: "Ross",
					GivenName:  "Bethany",
				},
				Emails: []*resources.ScimEmail{
					{
						Value:   minimalUsername + "@example.com",
						Primary: true,
					},
				},
			},
		},
		{
			name: "minimal inactive user",
			body: minimalInactiveUserJson,
			want: &resources.ScimUser{
				Active: schemas.NewRelaxedBool(false),
			},
		},
		{
			name: "full user",
			body: withUsername(fullUserJson, "bjensen"),
			want: fullUser,
		},
		{
			name: "no primary email and phone",
			body: minimalNoPrimaryEmailPhoneUserJson,
			want: &resources.ScimUser{
				Emails: []*resources.ScimEmail{
					{
						Value:   "user1-no-primary-email-phone@example.com",
						Primary: true,
					},
				},
				PhoneNumbers: []*resources.ScimPhoneNumber{
					{
						Value:   "+41711234567",
						Primary: true,
					},
				},
			},
		},
		{
			name:          "missing userName",
			wantErr:       true,
			scimErrorType: "invalidValue",
			body:          missingUserNameUserJson,
		},
		{
			// this is an expected schema violation
			name:          "missing name",
			wantErr:       true,
			scimErrorType: "invalidValue",
			body:          missingNameUserJson,
		},
		{
			name:          "missing email",
			wantErr:       true,
			scimErrorType: "invalidValue",
			body:          missingEmailUserJson,
		},
		{
			name:          "password complexity violation",
			wantErr:       true,
			scimErrorType: "invalidValue",
			body:          invalidPasswordUserJson,
		},
		{
			name:          "invalid profile url",
			wantErr:       true,
			scimErrorType: "invalidValue",
			zitadelErrID:  "SCIM-htturl1",
			body:          invalidProfileUrlUserJson,
		},
		{
			name:          "invalid time zone",
			wantErr:       true,
			scimErrorType: "invalidValue",
			body:          invalidTimeZoneUserJson,
		},
		{
			name:          "invalid locale",
			wantErr:       true,
			scimErrorType: "invalidValue",
			body:          invalidLocaleUserJson,
		},
		{
			name:        "not authenticated",
			body:        withUsername(minimalUserJson, gofakeit.Username()),
			ctx:         context.Background(),
			wantErr:     true,
			errorStatus: http.StatusUnauthorized,
		},
		{
			name:        "no permissions",
			body:        withUsername(minimalUserJson, gofakeit.Username()),
			ctx:         Instance.WithAuthorization(CTX, integration.UserTypeNoPermission),
			wantErr:     true,
			errorStatus: http.StatusNotFound,
		},
		{
			name:        "another org",
			body:        withUsername(minimalUserJson, gofakeit.Username()),
			orgID:       SecondaryOrganization.OrganizationId,
			wantErr:     true,
			errorStatus: http.StatusNotFound,
		},
	}
	for _, tt := range tests {
		t.Run(tt.name, func(t *testing.T) {
			ctx := tt.ctx
			if ctx == nil {
				ctx = CTX
			}

			orgID := tt.orgID
			if orgID == "" {
				orgID = Instance.DefaultOrg.Id
			}

			createdUser, err := Instance.Client.SCIM.Users.Create(ctx, orgID, tt.body)
			if (err != nil) != tt.wantErr {
				t.Errorf("CreateUser() error = %v, wantErr %v", err, tt.wantErr)
				return
			}

			if err != nil {
				statusCode := tt.errorStatus
				if statusCode == 0 {
					statusCode = http.StatusBadRequest
				}
				scimErr := scim.RequireScimError(t, statusCode, err)
				assert.Equal(t, tt.scimErrorType, scimErr.Error.ScimType)
				if tt.zitadelErrID != "" {
					assert.Equal(t, tt.zitadelErrID, scimErr.Error.ZitadelDetail.ID)
				}

				return
			}

			assert.NotEmpty(t, createdUser.ID)
			assert.EqualValues(t, []schemas.ScimSchemaType{"urn:ietf:params:scim:schemas:core:2.0:User"}, createdUser.Resource.Schemas)
			assert.Equal(t, schemas.ScimResourceTypeSingular("User"), createdUser.Resource.Meta.ResourceType)
			assert.Equal(t, "http://"+Instance.Host()+path.Join(schemas.HandlerPrefix, orgID, "Users", createdUser.ID), createdUser.Resource.Meta.Location)
			assert.Nil(t, createdUser.Password)

			if tt.want != nil {
				if !test.PartiallyDeepEqual(tt.want, createdUser) {
					t.Errorf("CreateUser() got = %v, want %v", createdUser, tt.want)
				}

				retryDuration, tick := integration.WaitForAndTickWithMaxDuration(CTX, time.Minute)
				require.EventuallyWithT(t, func(ttt *assert.CollectT) {
					// ensure the user is really stored and not just returned to the caller
					fetchedUser, err := Instance.Client.SCIM.Users.Get(CTX, Instance.DefaultOrg.Id, createdUser.ID)
					require.NoError(ttt, err)
					if !test.PartiallyDeepEqual(tt.want, fetchedUser) {
						ttt.Errorf("GetUser() got = %v, want %v", fetchedUser, tt.want)
					}
				}, retryDuration, tick)
			}
		})
	}
}

func TestCreateUser_duplicate(t *testing.T) {
	parsedMinimalUserJson := withUsername(minimalUserJson, gofakeit.Username())
	createdUser, err := Instance.Client.SCIM.Users.Create(CTX, Instance.DefaultOrg.Id, parsedMinimalUserJson)
	require.NoError(t, err)

	_, err = Instance.Client.SCIM.Users.Create(CTX, Instance.DefaultOrg.Id, parsedMinimalUserJson)
	scimErr := scim.RequireScimError(t, http.StatusConflict, err)
	assert.Equal(t, "User already exists", scimErr.Error.Detail)
	assert.Equal(t, "uniqueness", scimErr.Error.ScimType)

	_, err = Instance.Client.UserV2.DeleteUser(CTX, &user.DeleteUserRequest{UserId: createdUser.ID})
	require.NoError(t, err)
}

func TestCreateUser_metadata(t *testing.T) {
	username := gofakeit.Username()
	createdUser, err := Instance.Client.SCIM.Users.Create(CTX, Instance.DefaultOrg.Id, withUsername(fullUserJson, username))
	require.NoError(t, err)

	retryDuration, tick := integration.WaitForAndTickWithMaxDuration(CTX, time.Minute)
	require.EventuallyWithT(t, func(tt *assert.CollectT) {
		md, err := Instance.Client.Mgmt.ListUserMetadata(CTX, &management.ListUserMetadataRequest{
			Id: createdUser.ID,
		})
		require.NoError(tt, err)

		mdMap := make(map[string]string)
		for i := range md.Result {
			mdMap[md.Result[i].Key] = string(md.Result[i].Value)
		}

		test.AssertMapContains(tt, mdMap, "urn:zitadel:scim:name.honorificPrefix", "Ms.")
		test.AssertMapContains(tt, mdMap, "urn:zitadel:scim:timezone", "America/Los_Angeles")
		test.AssertMapContains(tt, mdMap, "urn:zitadel:scim:photos", `[{"value":"https://photos.example.com/profilephoto/72930000000Ccne/F","type":"photo"},{"value":"https://photos.example.com/profilephoto/72930000000Ccne/T","type":"thumbnail"}]`)
		test.AssertMapContains(tt, mdMap, "urn:zitadel:scim:addresses", `[{"type":"work","streetAddress":"100 Universal City Plaza","locality":"Hollywood","region":"CA","postalCode":"91608","country":"USA","formatted":"100 Universal City Plaza\nHollywood, CA 91608 USA","primary":true},{"type":"home","streetAddress":"456 Hollywood Blvd","locality":"Hollywood","region":"CA","postalCode":"91608","country":"USA","formatted":"456 Hollywood Blvd\nHollywood, CA 91608 USA"}]`)
		test.AssertMapContains(tt, mdMap, "urn:zitadel:scim:entitlements", `[{"value":"my-entitlement-1","display":"Entitlement 1","type":"main-entitlement","primary":true},{"value":"my-entitlement-2","display":"Entitlement 2","type":"secondary-entitlement"}]`)
		test.AssertMapContains(tt, mdMap, "urn:zitadel:scim:externalId", "701984")
		test.AssertMapContains(tt, mdMap, "urn:zitadel:scim:name.middleName", "Jane")
		test.AssertMapContains(tt, mdMap, "urn:zitadel:scim:name.honorificSuffix", "III")
		test.AssertMapContains(tt, mdMap, "urn:zitadel:scim:profileUrl", "http://login.example.com/bjensen")
		test.AssertMapContains(tt, mdMap, "urn:zitadel:scim:title", "Tour Guide")
		test.AssertMapContains(tt, mdMap, "urn:zitadel:scim:locale", "en-US")
		test.AssertMapContains(tt, mdMap, "urn:zitadel:scim:ims", `[{"value":"someaimhandle","type":"aim"},{"value":"twitterhandle","type":"X"}]`)
		test.AssertMapContains(tt, mdMap, "urn:zitadel:scim:roles", `[{"value":"my-role-1","display":"Rolle 1","type":"main-role","primary":true},{"value":"my-role-2","display":"Rolle 2","type":"secondary-role"}]`)
		test.AssertMapContains(tt, mdMap, "urn:zitadel:scim:emails", fmt.Sprintf(`[{"value":"%s@example.com","primary":true,"type":"work"},{"value":"%s+1@example.com","primary":false,"type":"home"}]`, username, username))
	}, retryDuration, tick)
}

func TestCreateUser_scopedExternalID(t *testing.T) {
	callingUserId, callingUserPat, err := Instance.CreateMachineUserPATWithMembership(CTX, "ORG_OWNER")
	require.NoError(t, err)
	ctx := integration.WithAuthorizationToken(CTX, callingUserPat)
	setProvisioningDomain(t, callingUserId, "fooBar")
	createdUser, err := Instance.Client.SCIM.Users.Create(ctx, Instance.DefaultOrg.Id, withUsername(fullUserJson, gofakeit.Username()))
	require.NoError(t, err)
	retryDuration, tick := integration.WaitForAndTickWithMaxDuration(ctx, time.Minute)
	require.EventuallyWithT(t, func(tt *assert.CollectT) {
		// unscoped externalID should not exist
		unscoped, err := Instance.Client.Mgmt.GetUserMetadata(ctx, &management.GetUserMetadataRequest{
			Id:  createdUser.ID,
			Key: "urn:zitadel:scim:externalId",
		})
		integration.AssertGrpcStatus(tt, codes.NotFound, err)
		unscoped = unscoped

		// scoped externalID should exist
		md, err := Instance.Client.Mgmt.GetUserMetadata(ctx, &management.GetUserMetadataRequest{
			Id:  createdUser.ID,
			Key: "urn:zitadel:scim:fooBar:externalId",
		})
		if !assert.NoError(tt, err) {
			require.Equal(tt, status.Code(err), codes.NotFound)
			return
		}
		assert.Equal(tt, "701984", string(md.Metadata.Value))
	}, retryDuration, tick)
}