add okta configuration steps for scim

[Muhammadsaeed707]

Adding Okta configuration steps for SCIM to the newly drafted SCIM documentation

This PR builds on top of #1845 by @Charlie-Boyer.

@Charlie-Boyer @Pierrci Would you mind reviewing this when you get a chance?

[HuggingFaceDocBuilderDev]

The docs for this PR live here. All of your documentation changes will be reflected on that endpoint. The docs are available until 30 days after the last update.

[pcuenca]

diff on top of #1845 for those that already reviewed it (or, alternatively, we could merge #1845 first).

[pcuenca]

Suggested change

	> **Note:**
	> - Only regular characters and `-` are accepted in the Username.
	> - `--` (double dash) is forbidden.
	> - `-` cannot start or end the name.
	> - Digit-only names are not accepted.
	> - Minimum length is 2 and maximum length is 42.
	> - Username has to be unique
	<tip>
	<ul>
	<li>Only regular characters and `-` are accepted in the Username.</li>
	<li>`--` (double dash) is forbidden.</li>
	<li>`-` cannot start or end the name.</li>
	<li>Digit-only names are not accepted.</li>
	<li>Minimum length is 2 and maximum length is 42.</li>
	<li>Username has to be unique.</li>
	</ul>
	</tip>

Just in case you prefer the "tip" rendering style (light green background, as shown at the end of this section).

[Muhammadsaeed707]

can change to tip if that is preferred @Pierrci

[Pierrci]

ah yes, maybe even <Tip warning={true}> so that it's with an orange background actually, this is an important precision I think

also, I would move that at the end of Step 4 I think, where you list the attributes

can you also add the same thing in the Entra doc? (cc @Charlie-Boyer)

and finally: Username has to be unique within your org for the last item (maybe that's what you meant, but let's make it clear so that people don't panic, since we're prefixing all the usernames by the org name)

[Muhammadsaeed707]

i think it makes sense to keep it where it is since this is where the username can be edited. After step 4 username is not able to be edited

[Pierrci]

can you push a merge commit w/ main (or rebase, as you prefer) now that #1845 has been merged @Muhammadsaeed707?

[Pierrci]

ah yes, maybe even <Tip warning={true}> so that it's with an orange background actually, this is an important precision I think

also, I would move that at the end of Step 4 I think, where you list the attributes

can you also add the same thing in the Entra doc? (cc @Charlie-Boyer)

and finally: Username has to be unique within your org for the last item (maybe that's what you meant, but let's make it clear so that people don't panic, since we're prefixing all the usernames by the org name)

[Charlie-Boyer]

This flow assumes the use of an app from the catalog. Since our SSO guide involves creating a custom app, I believe the flow is a bit different.

also adding a screenshot here would be nice I think