updated jwt and jwtClaim, moved security section

Author: rsill-neo4j

modules/ROOT/content-nav.adoc

@@ -6,7 +6,12 @@
 * xref:getting-started/toolbox.adoc[]
 
 * *Reference*
-
+* xref:security/index.adoc[]
+** xref:security/configuration.adoc[]
+** xref:security/authentication.adoc[]
+** xref:security/authorization.adoc[]
+** xref:security/impersonation-and-user-switching.adoc[]
+** xref:security/operations.adoc[]
 * xref:types/index.adoc[]
 ** xref:types/scalar.adoc[Scalar]
 ** xref:types/temporal.adoc[Temporal]
@@ -16,12 +21,7 @@
 ** xref:types/relationships.adoc[]
 * xref:directives/index.adoc[]
 ** xref:directives/database-mapping.adoc[]
-** xref:directives/security/index.adoc[]
-*** xref:directives/security/configuration.adoc[]
-*** xref:directives/security/authentication.adoc[]
-*** xref:directives/security/authorization.adoc[]
-*** xref:directives/security/impersonation-and-user-switching.adoc[]
-*** xref:directives/security/operations.adoc[]
+
 ** xref:directives/autogeneration.adoc[]
 ** xref:directives/schema-configuration/index.adoc[]
 *** xref:directives/schema-configuration/global-configuration.adoc[]

modules/ROOT/pages/directives/index.adoc

@@ -34,18 +34,18 @@ a| Required to differentiate interfaces that are used for relationship propertie
 |===
 | Directive | Description
 
-| xref::/directives/security/authentication.adoc[`@authentication`]
+| xref::/security/authentication.adoc[`@authentication`]
 | Requires authentication checks when accessing the type.
 
-| xref::/directives/security/authorization.adoc[`@authorization`]
+| xref::/security/authorization.adoc[`@authorization`]
 | Specifies authorization rules for queries and mutations on the type.
 
-| xref::/directives/security/configuration.adoc#authentication-and-authorization-jwt[`@jwt`]
-| Configure the JWT authentication filter to include an additional JWT claim.
+| xref::/security/configuration.adoc#authentication-and-authorization-jwt[`@jwt`]
+| Configures the JWT authentication and authorization filters to include additional JWT claims.
 
-| xref::/directives/security/configuration.adoc#_nested_claims[`@jwtClaim`]
-| Use in combination with `@jwt`. 
-Configures the JWT authentication filter to include an additional nested JWT claim.
+| xref::/security/configuration.adoc#_nested_claims[`@jwtClaim`]
+| Used in combination with `@jwt`.
+Configures the JWT authentication and authorization filters to include an additional JWT claim which is either nested or using special characters not supported by GraphQL.
 
 | `@subscriptionsAuthorization`
 | Specifies authorization rules for subscriptions on the type.

modules/ROOT/pages/directives/security/index.adoc

@@ -30,7 +30,7 @@ For every query and mutation that is executed against this generated schema, the
 - Extensive xref::queries-aggregations/filtering.adoc[Filtering] and xref::queries-aggregations/sorting.adoc[Sorting] options.
 - Options for xref::/directives/database-mapping.adoc[Database mapping] and value xref::/directives/autogeneration.adoc[Autogeneration].
 - xref::/queries-aggregations/pagination/index.adoc[Pagination] options.
-- xref::/directives/security/index.adoc[Security options] and additional xref::schema-configuration/index.adoc[Schema Configuration].
+- xref::/security/index.adoc[Security options] and additional xref::schema-configuration/index.adoc[Schema Configuration].
 - An xref::ogm/index.adoc[OGM] (Object Graph Mapper) for programmatic interaction with your GraphQL API.
 - A xref::getting-started/toolbox.adoc[Toolbox] (UI) to experiment with your Neo4j GraphQL API on Neo4j Desktop.
 

modules/ROOT/pages/index.adoc

@@ -0,0 +1,13 @@
+= Security
+:description: This section covers security features in the Neo4j GraphQL Library.
+:page-aliases: auth/index.adoc, auth/setup.adoc, auth/authentication.adoc, \
+auth/authorization.adoc, auth/auth-directive.adoc, auth/subscriptions.adoc, \
+auth/authorization/allow.adoc, auth/authorization/bind.adoc, auth/authorization/roles.adoc, \
+auth/authorization/where.adoc, authentication-and-authorization/index.adoc
+
+
+* xref::/security/authentication.adoc[Authentication] - Explicit authentication, configured using the `@authentication` directive.
+* xref::/security/authorization.adoc[Authorization] - Authorization rules set using the `@authorization` directive. 
+* xref::/security/configuration.adoc[Configuration] - Instructions to set up instantiation. 
+* xref::/security/impersonation-and-user-switching.adoc[Impersonation and user switching] - How to set up impersonation and user switching features.
+* xref::/security/operations.adoc[Operations] - Reference on GraphQL queries and how each location in each query triggers the evaluation of different authentication/authorization rules.