docs: add and use attribute for red hat sso token url (#546)

jbyrne-redhat · web-flow · commit 2bfe9b92ab23 · 2022-07-05T15:33:18.000+01:00
diff --git a/docs/_artifacts/document-attributes.adoc b/docs/_artifacts/document-attributes.adoc
@@ -11,6 +11,7 @@
 :property-file-name: app-services.properties
 :samples-git-repo: https://github.com/redhat-developer/app-services-guides
 :base-url: https://github.com/redhat-developer/app-services-guides/tree/main/docs/
+:sso-token-url: https://sso.redhat.com/auth/realms/redhat-external/protocol/openid-connect/token
 
 //OpenShift Application Services CLI
 :base-url-cli: https://github.com/redhat-developer/app-services-cli/tree/main/docs/
diff --git a/docs/api-designer/getting-started-api-designer/README.adoc b/docs/api-designer/getting-started-api-designer/README.adoc
@@ -11,6 +11,7 @@ WARNING: This content is generated by running npm --prefix .build run generate:a
 :property-file-name: app-services.properties
 :samples-git-repo: https://github.com/redhat-developer/app-services-guides
 :base-url: https://github.com/redhat-developer/app-services-guides/tree/main/docs/
+:sso-token-url: https://sso.redhat.com/auth/realms/redhat-external/protocol/openid-connect/token
 
 //OpenShift Application Services CLI
 :base-url-cli: https://github.com/redhat-developer/app-services-cli/tree/main/docs/
diff --git a/docs/connectors/getting-started-connectors/README.adoc b/docs/connectors/getting-started-connectors/README.adoc
@@ -11,6 +11,7 @@ WARNING: This content is generated by running npm --prefix .build run generate:a
 :property-file-name: app-services.properties
 :samples-git-repo: https://github.com/redhat-developer/app-services-guides
 :base-url: https://github.com/redhat-developer/app-services-guides/tree/main/docs/
+:sso-token-url: https://sso.redhat.com/auth/realms/redhat-external/protocol/openid-connect/token
 
 //OpenShift Application Services CLI
 :base-url-cli: https://github.com/redhat-developer/app-services-cli/tree/main/docs/
diff --git a/docs/kafka/access-mgmt-kafka/README.adoc b/docs/kafka/access-mgmt-kafka/README.adoc
@@ -11,6 +11,7 @@ WARNING: This content is generated by running npm --prefix .build run generate:a
 :property-file-name: app-services.properties
 :samples-git-repo: https://github.com/redhat-developer/app-services-guides
 :base-url: https://github.com/redhat-developer/app-services-guides/tree/main/docs/
+:sso-token-url: https://sso.redhat.com/auth/realms/redhat-external/protocol/openid-connect/token
 
 //OpenShift Application Services CLI
 :base-url-cli: https://github.com/redhat-developer/app-services-cli/tree/main/docs/
diff --git a/docs/kafka/consumer-configuration-kafka/README.adoc b/docs/kafka/consumer-configuration-kafka/README.adoc
@@ -11,6 +11,7 @@ WARNING: This content is generated by running npm --prefix .build run generate:a
 :property-file-name: app-services.properties
 :samples-git-repo: https://github.com/redhat-developer/app-services-guides
 :base-url: https://github.com/redhat-developer/app-services-guides/tree/main/docs/
+:sso-token-url: https://sso.redhat.com/auth/realms/redhat-external/protocol/openid-connect/token
 
 //OpenShift Application Services CLI
 :base-url-cli: https://github.com/redhat-developer/app-services-cli/tree/main/docs/
diff --git a/docs/kafka/getting-started-kafka/README.adoc b/docs/kafka/getting-started-kafka/README.adoc
@@ -11,6 +11,7 @@ WARNING: This content is generated by running npm --prefix .build run generate:a
 :property-file-name: app-services.properties
 :samples-git-repo: https://github.com/redhat-developer/app-services-guides
 :base-url: https://github.com/redhat-developer/app-services-guides/tree/main/docs/
+:sso-token-url: https://sso.redhat.com/auth/realms/redhat-external/protocol/openid-connect/token
 
 //OpenShift Application Services CLI
 :base-url-cli: https://github.com/redhat-developer/app-services-cli/tree/main/docs/
diff --git a/docs/kafka/kafka-bin-scripts-kafka/README.adoc b/docs/kafka/kafka-bin-scripts-kafka/README.adoc
@@ -11,6 +11,7 @@ WARNING: This content is generated by running npm --prefix .build run generate:a
 :property-file-name: app-services.properties
 :samples-git-repo: https://github.com/redhat-developer/app-services-guides
 :base-url: https://github.com/redhat-developer/app-services-guides/tree/main/docs/
+:sso-token-url: https://sso.redhat.com/auth/realms/redhat-external/protocol/openid-connect/token
 
 //OpenShift Application Services CLI
 :base-url-cli: https://github.com/redhat-developer/app-services-cli/tree/main/docs/
diff --git a/docs/kafka/kcat-kafka/README.adoc b/docs/kafka/kcat-kafka/README.adoc
@@ -11,6 +11,7 @@ WARNING: This content is generated by running npm --prefix .build run generate:a
 :property-file-name: app-services.properties
 :samples-git-repo: https://github.com/redhat-developer/app-services-guides
 :base-url: https://github.com/redhat-developer/app-services-guides/tree/main/docs/
+:sso-token-url: https://sso.redhat.com/auth/realms/redhat-external/protocol/openid-connect/token
 
 //OpenShift Application Services CLI
 :base-url-cli: https://github.com/redhat-developer/app-services-cli/tree/main/docs/
diff --git a/docs/kafka/message-browsing-kafka/README.adoc b/docs/kafka/message-browsing-kafka/README.adoc
@@ -11,6 +11,7 @@ WARNING: This content is generated by running npm --prefix .build run generate:a
 :property-file-name: app-services.properties
 :samples-git-repo: https://github.com/redhat-developer/app-services-guides
 :base-url: https://github.com/redhat-developer/app-services-guides/tree/main/docs/
+:sso-token-url: https://sso.redhat.com/auth/realms/redhat-external/protocol/openid-connect/token
 
 //OpenShift Application Services CLI
 :base-url-cli: https://github.com/redhat-developer/app-services-cli/tree/main/docs/
diff --git a/docs/kafka/metrics-monitoring-kafka/README.adoc b/docs/kafka/metrics-monitoring-kafka/README.adoc
@@ -11,6 +11,7 @@ WARNING: This content is generated by running npm --prefix .build run generate:a
 :property-file-name: app-services.properties
 :samples-git-repo: https://github.com/redhat-developer/app-services-guides
 :base-url: https://github.com/redhat-developer/app-services-guides/tree/main/docs/
+:sso-token-url: https://sso.redhat.com/auth/realms/redhat-external/protocol/openid-connect/token
 
 //OpenShift Application Services CLI
 :base-url-cli: https://github.com/redhat-developer/app-services-cli/tree/main/docs/
diff --git a/docs/kafka/nodejs-kafka/README.adoc b/docs/kafka/nodejs-kafka/README.adoc
@@ -11,6 +11,7 @@ WARNING: This content is generated by running npm --prefix .build run generate:a
 :property-file-name: app-services.properties
 :samples-git-repo: https://github.com/redhat-developer/app-services-guides
 :base-url: https://github.com/redhat-developer/app-services-guides/tree/main/docs/
+:sso-token-url: https://sso.redhat.com/auth/realms/redhat-external/protocol/openid-connect/token
 
 //OpenShift Application Services CLI
 :base-url-cli: https://github.com/redhat-developer/app-services-cli/tree/main/docs/
diff --git a/docs/kafka/quarkus-kafka/README.adoc b/docs/kafka/quarkus-kafka/README.adoc
@@ -11,6 +11,7 @@ WARNING: This content is generated by running npm --prefix .build run generate:a
 :property-file-name: app-services.properties
 :samples-git-repo: https://github.com/redhat-developer/app-services-guides
 :base-url: https://github.com/redhat-developer/app-services-guides/tree/main/docs/
+:sso-token-url: https://sso.redhat.com/auth/realms/redhat-external/protocol/openid-connect/token
 
 //OpenShift Application Services CLI
 :base-url-cli: https://github.com/redhat-developer/app-services-cli/tree/main/docs/
diff --git a/docs/kafka/rhoas-cli-getting-started-kafka/README.adoc b/docs/kafka/rhoas-cli-getting-started-kafka/README.adoc
@@ -11,6 +11,7 @@ WARNING: This content is generated by running npm --prefix .build run generate:a
 :property-file-name: app-services.properties
 :samples-git-repo: https://github.com/redhat-developer/app-services-guides
 :base-url: https://github.com/redhat-developer/app-services-guides/tree/main/docs/
+:sso-token-url: https://sso.redhat.com/auth/realms/redhat-external/protocol/openid-connect/token
 
 //OpenShift Application Services CLI
 :base-url-cli: https://github.com/redhat-developer/app-services-cli/tree/main/docs/
@@ -190,12 +191,12 @@ view the `credentials.json` file that you created.
 +
 --
 .Example `credentials.json` file
-[source,json]
+[source,json,subs="+attributes"]
 ----
 {
 	"clientID":"srvc-acct-8c95ca5e1225-94a-41f1-ab97-aacf3df1",
 	"clientSecret":"facf3df1-ab97-2253-aa87-ab97",
-    "oauthTokenUrl": "https://sso.redhat.com/auth/realms/redhat-external/protocol/openid-connect/token"
+    "oauthTokenUrl": "{sso-token-url}"
 }
 ----
 You use these credentials and the bootstrap server URL to connect your applications and services to your Kafka instance.
diff --git a/docs/kafka/service-binding-kafka/README.adoc b/docs/kafka/service-binding-kafka/README.adoc
@@ -11,6 +11,7 @@ WARNING: This content is generated by running npm --prefix .build run generate:a
 :property-file-name: app-services.properties
 :samples-git-repo: https://github.com/redhat-developer/app-services-guides
 :base-url: https://github.com/redhat-developer/app-services-guides/tree/main/docs/
+:sso-token-url: https://sso.redhat.com/auth/realms/redhat-external/protocol/openid-connect/token
 
 //OpenShift Application Services CLI
 :base-url-cli: https://github.com/redhat-developer/app-services-cli/tree/main/docs/
diff --git a/docs/kafka/topic-configuration-kafka/README.adoc b/docs/kafka/topic-configuration-kafka/README.adoc
@@ -11,6 +11,7 @@ WARNING: This content is generated by running npm --prefix .build run generate:a
 :property-file-name: app-services.properties
 :samples-git-repo: https://github.com/redhat-developer/app-services-guides
 :base-url: https://github.com/redhat-developer/app-services-guides/tree/main/docs/
+:sso-token-url: https://sso.redhat.com/auth/realms/redhat-external/protocol/openid-connect/token
 
 //OpenShift Application Services CLI
 :base-url-cli: https://github.com/redhat-developer/app-services-cli/tree/main/docs/
diff --git a/docs/registry/access-mgmt-registry/README.adoc b/docs/registry/access-mgmt-registry/README.adoc
@@ -11,6 +11,7 @@ WARNING: This content is generated by running npm --prefix .build run generate:a
 :property-file-name: app-services.properties
 :samples-git-repo: https://github.com/redhat-developer/app-services-guides
 :base-url: https://github.com/redhat-developer/app-services-guides/tree/main/docs/
+:sso-token-url: https://sso.redhat.com/auth/realms/redhat-external/protocol/openid-connect/token
 
 //OpenShift Application Services CLI
 :base-url-cli: https://github.com/redhat-developer/app-services-cli/tree/main/docs/
diff --git a/docs/registry/getting-started-registry/README.adoc b/docs/registry/getting-started-registry/README.adoc
@@ -11,6 +11,7 @@ WARNING: This content is generated by running npm --prefix .build run generate:a
 :property-file-name: app-services.properties
 :samples-git-repo: https://github.com/redhat-developer/app-services-guides
 :base-url: https://github.com/redhat-developer/app-services-guides/tree/main/docs/
+:sso-token-url: https://sso.redhat.com/auth/realms/redhat-external/protocol/openid-connect/token
 
 //OpenShift Application Services CLI
 :base-url-cli: https://github.com/redhat-developer/app-services-cli/tree/main/docs/
diff --git a/docs/registry/quarkus-registry/README.adoc b/docs/registry/quarkus-registry/README.adoc
@@ -11,6 +11,7 @@ WARNING: This content is generated by running npm --prefix .build run generate:a
 :property-file-name: app-services.properties
 :samples-git-repo: https://github.com/redhat-developer/app-services-guides
 :base-url: https://github.com/redhat-developer/app-services-guides/tree/main/docs/
+:sso-token-url: https://sso.redhat.com/auth/realms/redhat-external/protocol/openid-connect/token
 
 //OpenShift Application Services CLI
 :base-url-cli: https://github.com/redhat-developer/app-services-cli/tree/main/docs/
diff --git a/docs/registry/rhoas-cli-getting-started-registry/README.adoc b/docs/registry/rhoas-cli-getting-started-registry/README.adoc
@@ -11,6 +11,7 @@ WARNING: This content is generated by running npm --prefix .build run generate:a
 :property-file-name: app-services.properties
 :samples-git-repo: https://github.com/redhat-developer/app-services-guides
 :base-url: https://github.com/redhat-developer/app-services-guides/tree/main/docs/
+:sso-token-url: https://sso.redhat.com/auth/realms/redhat-external/protocol/openid-connect/token
 
 //OpenShift Application Services CLI
 :base-url-cli: https://github.com/redhat-developer/app-services-cli/tree/main/docs/
@@ -194,12 +195,12 @@ view the `credentials.json` file that you created.
 +
 --
 .Example `credentials.json` file
-[source,json]
+[source,json,subs="+attributes"]
 ----
 {
 	"clientID":"srvc-acct-8c95ca5e1225-94a-41f1-ab97-aacf3df1",
 	"clientSecret":"facf3df1-ab97-2253-aa87-ab97",
-    "oauthTokenUrl": "https://sso.redhat.com/auth/realms/redhat-external/protocol/openid-connect/token"
+    "oauthTokenUrl": "{sso-token-url}"
 }
 ----
 You use these credentials and the {registry} URL to connect your applications and services to your {registry} instance.
diff --git a/docs/registry/service-binding-registry/README.adoc b/docs/registry/service-binding-registry/README.adoc
@@ -11,6 +11,7 @@ WARNING: This content is generated by running npm --prefix .build run generate:a
 :property-file-name: app-services.properties
 :samples-git-repo: https://github.com/redhat-developer/app-services-guides
 :base-url: https://github.com/redhat-developer/app-services-guides/tree/main/docs/
+:sso-token-url: https://sso.redhat.com/auth/realms/redhat-external/protocol/openid-connect/token
 
 //OpenShift Application Services CLI
 :base-url-cli: https://github.com/redhat-developer/app-services-cli/tree/main/docs/
diff --git a/docs/rhoas/rhoas-cli-installation/README.adoc b/docs/rhoas/rhoas-cli-installation/README.adoc
@@ -11,6 +11,7 @@ WARNING: This content is generated by running npm --prefix .build run generate:a
 :property-file-name: app-services.properties
 :samples-git-repo: https://github.com/redhat-developer/app-services-guides
 :base-url: https://github.com/redhat-developer/app-services-guides/tree/main/docs/
+:sso-token-url: https://sso.redhat.com/auth/realms/redhat-external/protocol/openid-connect/token
 
 //OpenShift Application Services CLI
 :base-url-cli: https://github.com/redhat-developer/app-services-cli/tree/main/docs/
diff --git a/docs/rhoas/rhoas-service-contexts/README.adoc b/docs/rhoas/rhoas-service-contexts/README.adoc
@@ -11,6 +11,7 @@ WARNING: This content is generated by running npm --prefix .build run generate:a
 :property-file-name: app-services.properties
 :samples-git-repo: https://github.com/redhat-developer/app-services-guides
 :base-url: https://github.com/redhat-developer/app-services-guides/tree/main/docs/
+:sso-token-url: https://sso.redhat.com/auth/realms/redhat-external/protocol/openid-connect/token
 
 //OpenShift Application Services CLI
 :base-url-cli: https://github.com/redhat-developer/app-services-cli/tree/main/docs/
@@ -291,7 +292,7 @@ $ cp ./producer/.env ./consumer/.env
 For a service context with single Kafka and {registry} instances, the `.env` file looks like the following example:
 +
 .Example environment variables file for connection configuration information
-[source,shell]
+[source,shell,subs="+attributes"]
 ----
 ## Generated by rhoas cli
 ## Kafka Configuration
@@ -304,7 +305,7 @@ SERVICE_REGISTRY_COMPAT_PATH=/apis/ccompat/v6
 ## Authentication Configuration
 RHOAS_CLIENT_ID=srvc-acct-14295e3c-f72d-4bae-876c-3172a96eb7eb
 RHOAS_CLIENT_SECRET=5c3a20e0-d946-4edf-94d2-35db41f3b2ad
-RHOAS_OAUTH_TOKEN_URL=https://sso.redhat.com/auth/realms/redhat-external/protocol/openid-connect/token
+RHOAS_OAUTH_TOKEN_URL={sso-token-url}
 ----
 +
 As shown in the example, the file that you generate contains the endpoints for your service instances, and the credentials required to connect to those instances. The CLI automatically created a service account (under the environment variable name `RHOAS_CLIENT_ID`) that client applications can use to authenticate with the Kafka and {registry} instances.
