Update the cypher test setup in Database administration and Authentication and Authorization sections by renetapopova · Pull Request #3206 · neo4j/docs-operations

renetapopova · 2026-07-23T13:44:52Z

…ation and Authorization sections

Hunterness

I have 7 files left to look at but pausing for lunch so I'm posting the comments I have so far

Hunterness

review of remaining files

Hunterness

Review of updates

Hunterness

So I'm leaving on vacation now and won't be able to continue reviewing this (I'll make sure someone else from the team picks it up).

The only things I don't really agree with are the manage-users setup: the show examples assume one user that is added in the create examples (after the show) and not the ones you added in the setup. Additionally, one of the setup users should not be there at all as the one from create is renamed to that name and the second one (alice) can probably just not exist as per the comment where she is used 🤷 There are also some setup that might be needed for later sections that the earlier ones don't consider so having it as the page setup feels odd but it might still be good to add for those sections 🤷

And then there is my two comments on the manage-privileges page that I guess we'll open a new PR to fix later as they don't have to do with the setup but are still wrong.

Hunterness

Re-reviewed the users and role pages, still have to look at the privilege page but I'm breaking for the day so here are the comments I have so far

Status: 3 open comments

Hunterness

Not that many comments on the privilege file at least 🎉

renetapopova · 2026-08-20T13:42:22Z

@@ -1244,7 +1219,7 @@ SET STATUS ACTIVE;
 The equivalent command using the xref:authentication-authorization/auth-providers.adoc[auth providers] syntax would be:


Suggested change

The equivalent command using the xref:authentication-authorization/auth-providers.adoc[auth providers] syntax would be:

Alternatively, you can use the xref:authentication-authorization/auth-providers.adoc[auth providers] syntax, for example:

this update seems to have been lost as I don't see it when looking at all changes, the sentence still says "equivalent command"

because the user is the same - jake

…ation and Authorization sections

…the results

Hunterness

Re-review, some new comments and some old ones re-opened as they had not been fixed

Hunterness · 2026-08-21T07:50:53Z

+| "joe"   | ["PUBLIC"]          | TRUE                   | TRUE      | "anotherdb" | "native" | {changeRequired: TRUE, password: "***"}  |
+| "molly" | ["PUBLIC"]          | FALSE                  | FALSE     | NULL        | "native" | {changeRequired: FALSE, password: "***"} |
+| "neo4j" | ["admin", "PUBLIC"] | FALSE                  | FALSE     | NULL        | "native" | {changeRequired: FALSE, password: "***"} |
+----------------------------------------------------------------------------------------------------------------------------------------+


this doesn't have to do with auth rules? it has to do with native vs external auth for the users?

and it might be nice for this example if we add in another user with multiple auths to show the behaviour

CREATE USER sandra SET AUTH 'native' {SET PASSWORD 'abcd1234' SET PASSWORD CHANGE NOT REQUIRED} SET AUTH 'oidc1' {SET ID 'sandrasUniqueMySsoId'};

Hunterness · 2026-08-21T07:59:55Z

@@ -1244,7 +1219,7 @@ SET STATUS ACTIVE;
 The equivalent command using the xref:authentication-authorization/auth-providers.adoc[auth providers] syntax would be:


this update seems to have been lost as I don't see it when looking at all changes, the sentence still says "equivalent command"

Hunterness · 2026-08-21T08:04:16Z

+  [SET TAG[S] tags] # <4>
 ----
 Where:



the list below need to be updated to reflect the tags update:

the <2> needs updating for syntax:

<2> Removes one, several, or all existing tags from each listed user. Use `REMOVE TAG[S] tag` to remove specific tags, or `REMOVE ALL TAG[S]` to remove every tag.

and then we should add the

Specific tags must be supplied as a single quoted `STRING` value, a `LIST` containing `STRING` values, or a parameter resolving to a `STRING` or a `LIST<STRING>`.

sentence to the general paragraph below that talks about where the tags are used from

This is about removing tags, not adding them. Why do you want to add the sentence here?

Hunterness · 2026-08-21T09:22:24Z

Beware #3245, so we don't get weird ordering or examples out of sync as you are both changing things here (and in the roles file)

I added a comment on that one as well: #3245 (comment)

Co-authored-by: Therese Magnusson <scout.therese@gmail.com>

…ty ID provider

neo4j-docops-agent · 2026-08-21T16:00:46Z

This PR includes documentation updates
View the updated docs at https://neo4j-docs-operations-3206.surge.sh

Updated pages:

renetapopova requested a review from Hunterness July 23, 2026 13:44

renetapopova added the cherry-pick-this-to-main label Jul 23, 2026

renetapopova changed the title ~~Update the cypher test setup in Database administration and Authentic…~~ Update the cypher test setup in Database administration and Authentication and Authorization sections Jul 23, 2026

Hunterness added the team-cypher-operations Cypher operations should review this label Jul 23, 2026

Hunterness reviewed Jul 28, 2026

View reviewed changes

Hunterness self-assigned this Jul 28, 2026

Hunterness reviewed Jul 29, 2026

View reviewed changes

renetapopova unassigned Hunterness Jul 29, 2026

renetapopova requested a review from Hunterness August 18, 2026 11:58

renetapopova assigned Chunyu01 and Hunterness and unassigned Chunyu01 Aug 18, 2026

Hunterness reviewed Aug 19, 2026

View reviewed changes

Hunterness reviewed Aug 20, 2026

View reviewed changes

Comment thread modules/ROOT/pages/authentication-authorization/manage-privileges.adoc Outdated

Comment thread modules/ROOT/pages/authentication-authorization/manage-privileges.adoc

renetapopova commented Aug 20, 2026

View reviewed changes

renetapopova added 12 commits August 20, 2026 19:14

Update the cypher test setup in Database administration and Authentic…

c126a0a

…ation and Authorization sections

More clean up

999fe99

apply some suggestions

db909be

update manage-aliases-standard-databases

14fb799

remove database scripts and add drivers settings back

3c27c65

check all examples work on Role-based access control page and update …

bdf9d17

…the results

check all examples work on the Manage users page and update the results

1493e56

drop all users except neo4j

27721f6

check all examples work on the Manage roles page and update the results

d19d402

update manage users

e98308e

update the number of listed privileges

2418cd9

add auth rules to show the example of roles assigned to auth rules

4214977

renetapopova force-pushed the dev-update-list-of-roles branch from 757f242 to 4214977 Compare August 20, 2026 18:14

Hunterness reviewed Aug 21, 2026

View reviewed changes

Hunterness mentioned this pull request Aug 21, 2026

COPS-569: Show users and roles as commands #3245

Open

Hunterness reviewed Aug 21, 2026

View reviewed changes

renetapopova and others added 2 commits August 21, 2026 14:20

Apply suggestion from @Hunterness

25f0a52

Co-authored-by: Therese Magnusson <scout.therese@gmail.com>

remove the note from places that do not talk about setting tags

83c76fc

Hunterness reviewed Aug 21, 2026

View reviewed changes

Comment thread modules/ROOT/pages/authentication-authorization/manage-users.adoc Outdated

Comment thread modules/ROOT/pages/authentication-authorization/manage-users.adoc Outdated

renetapopova added 3 commits August 21, 2026 16:10

revert the structure and update add the syntax in tab examples

f7c2fc0

apply further suggestions from review

3e43350

update user jessy to have both a native auth provider and a third-par…

6beb56c

…ty ID provider

		@@ -1244,7 +1219,7 @@ SET STATUS ACTIVE;
		The equivalent command using the xref:authentication-authorization/auth-providers.adoc[auth providers] syntax would be:

	The equivalent command using the xref:authentication-authorization/auth-providers.adoc[auth providers] syntax would be:
	Alternatively, you can use the xref:authentication-authorization/auth-providers.adoc[auth providers] syntax, for example:

Uh oh!

Conversation

renetapopova commented Jul 23, 2026

Uh oh!

Hunterness left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Hunterness left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Hunterness left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Hunterness left a comment

Choose a reason for hiding this comment

Uh oh!

Hunterness left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Hunterness left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Hunterness left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Hunterness left a comment •

edited

Loading

Hunterness left a comment •

edited

Loading

Hunterness left a comment •

edited

Loading