diff --git a/docs/GraFx-Studio/connectors/connector-sitecore-content-hub/index.md b/docs/GraFx-Studio/connectors/connector-sitecore-content-hub/index.md new file mode 100644 index 00000000..1b334adc --- /dev/null +++ b/docs/GraFx-Studio/connectors/connector-sitecore-content-hub/index.md @@ -0,0 +1,136 @@ +# Media Connector for Sitecore Content Hub + +| | Connector Type | +| --- | --- | +| | Built-in | +| :fontawesome-regular-square-check: | Built by CHILI publish | +| | Third party | + +[See Connector Types](/GraFx-Studio/concepts/connectors/#types-of-connectors) + +## Installation + +As no "installation" happens, you could also talk about deployment of a connector on your environment. + +[See Installation Through Connector Hub](/GraFx-Studio/guides/connector-hub/) + +## Sitecore Configuration + +Consult your [Sitecore documentation](https://doc.sitecore.com/ch/en/users/content-hub/create-an-oauth-client.html) or Sitecore System Admin to obtain the correct values for the fields. + +- **OAuth admin console** +``` html +https:///en-us/admin/oauthclients +``` + +- **Redirect URL** (only used if grafx config is Authorization Code): +``` html +https://.chili-publish.online/grafx/api/v1/environment//connectors//auth/oauth-authorization-code/redirect +``` + +## CHILI GraFx Connector Configuration + +From the overview of Environments, click on "Settings" on the right to your environment, where you want to install or configure the Connector. + +![screenshot-full](sch13.jpg) + +Then click the installed Connector to access the configuration. + +![screenshot-full](sch12.png) + +### Base Configuration + +Your instance of the Connector needs to know which Sitecore Content Hub instance it should communicate with and how to authenticate. + +![screenshot-full](sch01.png) + +### Authentication + +Select your type of authentication: + +**Supported on Server:** OAuth 2.0 Resource Owner Password +This is the flow where username and password (contenthub credentials) are needed. It makes all requests as that specific user. + +**Supported on Browser:** OAuth 2.0 Authorization Code (Browser only) + +![screenshot](sch02.png) + +- **Client ID** and **Client Secret**: These are [customer-specific credentials](https://doc.sitecore.com/ch/en/users/content-hub/create-an-oauth-client.html) provided by the Sitecore Admin when creating integrations within Sitecore. +- **Username** and **Password**: User-specific credentials for authentication. +- **Token Endpoint**: Developer-oriented settings available in Sitecore documentation. These settings are generic for all Sitecore clients. +- **Scope**: Consult your Sitecore Admin to determine the appropriate scope. + +You can configure separate authentication for machine-to-machine and browser use cases or use the same setup for both. + +![screenshot-full](sch04.png) + +- **Authorization Endpoint** https:///oauth/authorize +- **Token Endpoint** https://{SITECORE_CONTENTHUB_PATH}/oauth/token + + +Consult your Sitecore System Admin for assistance in configuring these fields. + +### Server Authentication + +The credentials used for machine-to-machine authentication determine the governance on assets in automation workflows. + +This means that if the credentials restrict access to specific assets, only those assets will be available during batch processing. + + + +### Browser Authentication or Impersonation + +GraFx Studio accesses assets available in the DAM via impersonation, where the credentials configured for the connector determine which assets are visible to the user in the template. + +**Impersonation** is the process of granting GraFx Studio users access to the DAM system using pre-configured credentials. This ensures seamless integration while respecting the DAM's security and governance rules. + +For example: +- A marketing team uses GraFx Studio to connect to Sitecore Content Hub. The admin configures the connector with specific credentials. +- Based on these credentials, users can only access assets they are authorized to view according to Sitecore's governance policies. + +## Using Assets from Your Sitecore Content Hub System + +### Place Assets in Your Template + +- Select the Sitecore Content Hub Connector. + +![screenshot-full](sch07.png) + +![screenshot-full](sch08.png) + +![screenshot-full](sch09.png) + +Depending on the configuration, you may need to authenticate. + +![screenshot-full](sch10.png) + +- Once authenticated, Sitecore assets behave like any other asset in GraFx Studio. + +### Image Variables + +When using [image variables](/GraFx-Studio/guides/template-variables/assign/#assign-template-variable-to-image-frame), you will see the same list of assets when selecting an image. + +![screenshot-full](var01.png) + +### Configuration Options + +#### Introduction + +To filter the assets suggested to template users, you can use categories, keywords, or other search parameters. + +Sitecore Content Hub supports search queries through its query language. Consult the [Sitecore Documentation](https://doc.sitecore.com/ch/en/developers/cloud-dev/generic-properties.html) or your Sitecore Content Hub Administrator for guidance. + +#### How To + +Queries are set at the variable level. + +Set the query value in the connector settings. + +![screenshot-full](var02.png) + +For more dynamic queries, you can use [variables](/GraFx-Studio/concepts/variables/), [actions](/GraFx-Studio/concepts/actions/), and [GraFx Genie](/GraFx-Studio/concepts/grafx-genie/) to automate and refine your queries. + +#### Other Configuration Options + +- **Show Only Approved Assets**: Displays only assets that have been approved in Sitecore Content Hub. +- **Locale**: Filters assets by region or language. \ No newline at end of file diff --git a/docs/GraFx-Studio/connectors/connector-sitecore-content-hub/sch01.png b/docs/GraFx-Studio/connectors/connector-sitecore-content-hub/sch01.png new file mode 100644 index 00000000..810fdd72 Binary files /dev/null and b/docs/GraFx-Studio/connectors/connector-sitecore-content-hub/sch01.png differ diff --git a/docs/GraFx-Studio/connectors/connector-sitecore-content-hub/sch02.png b/docs/GraFx-Studio/connectors/connector-sitecore-content-hub/sch02.png new file mode 100644 index 00000000..95853ef1 Binary files /dev/null and b/docs/GraFx-Studio/connectors/connector-sitecore-content-hub/sch02.png differ diff --git a/docs/GraFx-Studio/connectors/connector-sitecore-content-hub/sch03.png b/docs/GraFx-Studio/connectors/connector-sitecore-content-hub/sch03.png new file mode 100644 index 00000000..916665ff Binary files /dev/null and b/docs/GraFx-Studio/connectors/connector-sitecore-content-hub/sch03.png differ diff --git a/docs/GraFx-Studio/connectors/connector-sitecore-content-hub/sch04.png b/docs/GraFx-Studio/connectors/connector-sitecore-content-hub/sch04.png new file mode 100644 index 00000000..360a9e22 Binary files /dev/null and b/docs/GraFx-Studio/connectors/connector-sitecore-content-hub/sch04.png differ diff --git a/docs/GraFx-Studio/connectors/connector-sitecore-content-hub/sch05.png b/docs/GraFx-Studio/connectors/connector-sitecore-content-hub/sch05.png new file mode 100644 index 00000000..15fbe157 Binary files /dev/null and b/docs/GraFx-Studio/connectors/connector-sitecore-content-hub/sch05.png differ diff --git a/docs/GraFx-Studio/connectors/connector-sitecore-content-hub/sch06.png b/docs/GraFx-Studio/connectors/connector-sitecore-content-hub/sch06.png new file mode 100644 index 00000000..da31cf36 Binary files /dev/null and b/docs/GraFx-Studio/connectors/connector-sitecore-content-hub/sch06.png differ diff --git a/docs/GraFx-Studio/connectors/connector-sitecore-content-hub/sch07.png b/docs/GraFx-Studio/connectors/connector-sitecore-content-hub/sch07.png new file mode 100644 index 00000000..2ee56da7 Binary files /dev/null and b/docs/GraFx-Studio/connectors/connector-sitecore-content-hub/sch07.png differ diff --git a/docs/GraFx-Studio/connectors/connector-sitecore-content-hub/sch08.png b/docs/GraFx-Studio/connectors/connector-sitecore-content-hub/sch08.png new file mode 100644 index 00000000..cbc7024f Binary files /dev/null and b/docs/GraFx-Studio/connectors/connector-sitecore-content-hub/sch08.png differ diff --git a/docs/GraFx-Studio/connectors/connector-sitecore-content-hub/sch09.png b/docs/GraFx-Studio/connectors/connector-sitecore-content-hub/sch09.png new file mode 100644 index 00000000..92ae43b6 Binary files /dev/null and b/docs/GraFx-Studio/connectors/connector-sitecore-content-hub/sch09.png differ diff --git a/docs/GraFx-Studio/connectors/connector-sitecore-content-hub/sch10.png b/docs/GraFx-Studio/connectors/connector-sitecore-content-hub/sch10.png new file mode 100644 index 00000000..c50fb4a2 Binary files /dev/null and b/docs/GraFx-Studio/connectors/connector-sitecore-content-hub/sch10.png differ diff --git a/docs/GraFx-Studio/connectors/connector-sitecore-content-hub/sch11.png b/docs/GraFx-Studio/connectors/connector-sitecore-content-hub/sch11.png new file mode 100644 index 00000000..d6b271e8 Binary files /dev/null and b/docs/GraFx-Studio/connectors/connector-sitecore-content-hub/sch11.png differ diff --git a/docs/GraFx-Studio/connectors/connector-sitecore-content-hub/sch12.png b/docs/GraFx-Studio/connectors/connector-sitecore-content-hub/sch12.png new file mode 100644 index 00000000..28bdcdff Binary files /dev/null and b/docs/GraFx-Studio/connectors/connector-sitecore-content-hub/sch12.png differ diff --git a/docs/GraFx-Studio/connectors/connector-sitecore-content-hub/sch13.jpg b/docs/GraFx-Studio/connectors/connector-sitecore-content-hub/sch13.jpg new file mode 100644 index 00000000..ac14af18 Binary files /dev/null and b/docs/GraFx-Studio/connectors/connector-sitecore-content-hub/sch13.jpg differ diff --git a/docs/GraFx-Studio/connectors/connector-sitecore-content-hub/var01.png b/docs/GraFx-Studio/connectors/connector-sitecore-content-hub/var01.png new file mode 100644 index 00000000..baa828b3 Binary files /dev/null and b/docs/GraFx-Studio/connectors/connector-sitecore-content-hub/var01.png differ diff --git a/docs/GraFx-Studio/connectors/connector-sitecore-content-hub/var02.png b/docs/GraFx-Studio/connectors/connector-sitecore-content-hub/var02.png new file mode 100644 index 00000000..0ae7319f Binary files /dev/null and b/docs/GraFx-Studio/connectors/connector-sitecore-content-hub/var02.png differ diff --git a/mkdocs.yml b/mkdocs.yml index 69af0ace..03f50bc4 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -304,7 +304,8 @@ nav: - 'Manage User interfaces': 'GraFx-Studio/guides/manage-user-interfaces/index.md' - 'Connectors': - 'GraFx Media': 'GraFx-Studio/connectors/connector-grafx-media/index.md' - - 'Acquia DAM': 'GraFx-Studio/connectors/connector-acquia-dam/index.md' + - 'Acquia DAM': 'GraFx-Studio/connectors/connector-acquia-dam/index.md' + - 'Sitecore Content Hub': 'GraFx-Studio/connectors/connector-sitecore-content-hub/index.md' - 'Plugins': - 'Conversion': 'GraFx-Studio/convert/intro/index.md' - 'for Adobe® InDesign®': 'GraFx-Studio/convert/Adobe-InDesign/index.md'