chore: add wget example and cross-reference to ´ocm get credentials` docs (#1880)

On-behalf-of: Gerald Morrison (SAP) <gerald.morrison@sap.com>

<!-- markdownlint-disable MD041 -->
#### What this PR does / why we need it
Adds cross reference from wget access method to credential mapping and
add an example for wget in ocmconfig.

#### Which issue(s) this PR is related to
Related to #1821

Signed-off-by: Gerald Morrison (SAP) <gerald.morrison@sap.com>
Co-authored-by: Gerald Morrison (SAP) <gerald.morrison@sap.com>

Author: morri-son

api/ocm/extensions/accessmethods/wget/cli.go

@@ -2,6 +2,7 @@ package wget
 
 import (
 	"ocm.software/ocm/api/ocm/extensions/accessmethods/options"
+	"ocm.software/ocm/api/tech/wget/identity"
 	"ocm.software/ocm/api/utils/cobrautils/flagsets"
 	"ocm.software/ocm/api/utils/mime"
 )
@@ -68,4 +69,7 @@ This OPTIONAL property describes the http body to be included in the request.
 
 This OPTIONAL property describes whether http redirects should be disabled. If omitted,
 it is defaulted to false (so, per default, redirects are enabled).
+
+It uses the consumer identity type ` + identity.CONSUMER_TYPE + ` with the fields
+for a hostpath identity matcher (see <CMD>ocm get credentials</CMD>).
 `

cmds/ocm/topics/common/config/topic.go

@@ -22,11 +22,28 @@ configurations:
    - type: attributes.config.ocm.software
      attributes:  # map of attribute settings
        compat: true
+# Scripts configuration example
 #  - type: scripts.ocm.config.ocm.software
 #    scripts:
 #      "default":
 #         script:
 #           process: true
+# wget credential configuration example
+#  - type: credentials.config.ocm.software
+#    consumers:
+#      - identity:
+#          type: wget
+#          hostname: example.com
+#          # scheme: https   (optional)
+#          # port: 443       (optional)
+#          # pathprefix: /api (optional)
+#        credentials:
+#          - type: Credentials
+#            properties:
+#              username: myuser
+#              password: mypassword
+#              # or identityToken: bearer‑token
+#              # or certificate, privateKey, certificateAuthority for mTLS
 `,
 		Annotations: map[string]string{"ExampleCodeStyle": "yaml"},
 		Long: `

docs/reference/ocm_add_resource-configuration.md

@@ -1006,6 +1006,9 @@ shown below.
     This OPTIONAL property describes whether http redirects should be disabled. If omitted,
     it is defaulted to false (so, per default, redirects are enabled).
 
+    It uses the consumer identity type wget with the fields
+    for a hostpath identity matcher (see [ocm get credentials](ocm_get_credentials.md)).
+
   Options used to configure fields: <code>--body</code>, <code>--header</code>, <code>--mediaType</code>, <code>--noredirect</code>, <code>--url</code>, <code>--verb</code>
 
 

docs/reference/ocm_add_resources.md

@@ -1018,6 +1018,9 @@ shown below.
     This OPTIONAL property describes whether http redirects should be disabled. If omitted,
     it is defaulted to false (so, per default, redirects are enabled).
 
+    It uses the consumer identity type wget with the fields
+    for a hostpath identity matcher (see [ocm get credentials](ocm_get_credentials.md)).
+
   Options used to configure fields: <code>--body</code>, <code>--header</code>, <code>--mediaType</code>, <code>--noredirect</code>, <code>--url</code>, <code>--verb</code>
 
 

docs/reference/ocm_add_source-configuration.md

@@ -1006,6 +1006,9 @@ shown below.
     This OPTIONAL property describes whether http redirects should be disabled. If omitted,
     it is defaulted to false (so, per default, redirects are enabled).
 
+    It uses the consumer identity type wget with the fields
+    for a hostpath identity matcher (see [ocm get credentials](ocm_get_credentials.md)).
+
   Options used to configure fields: <code>--body</code>, <code>--header</code>, <code>--mediaType</code>, <code>--noredirect</code>, <code>--url</code>, <code>--verb</code>
 
 

docs/reference/ocm_add_sources.md

@@ -1016,6 +1016,9 @@ shown below.
     This OPTIONAL property describes whether http redirects should be disabled. If omitted,
     it is defaulted to false (so, per default, redirects are enabled).
 
+    It uses the consumer identity type wget with the fields
+    for a hostpath identity matcher (see [ocm get credentials](ocm_get_credentials.md)).
+
   Options used to configure fields: <code>--body</code>, <code>--header</code>, <code>--mediaType</code>, <code>--noredirect</code>, <code>--url</code>, <code>--verb</code>
 
 

docs/reference/ocm_configfile.md

@@ -389,11 +389,28 @@ configurations:
    - type: attributes.config.ocm.software
      attributes:  # map of attribute settings
        compat: true
+# Scripts configuration example
 #  - type: scripts.ocm.config.ocm.software
 #    scripts:
 #      "default":
 #         script:
 #           process: true
+# wget credential configuration example
+#  - type: credentials.config.ocm.software
+#    consumers:
+#      - identity:
+#          type: wget
+#          hostname: example.com
+#          # scheme: https   (optional)
+#          # port: 443       (optional)
+#          # pathprefix: /api (optional)
+#        credentials:
+#          - type: Credentials
+#            properties:
+#              username: myuser
+#              password: mypassword
+#              # or identityToken: bearer‑token
+#              # or certificate, privateKey, certificateAuthority for mTLS
 ```
 
 ### SEE ALSO

docs/reference/ocm_ocm-accessmethods.md

@@ -391,6 +391,9 @@ shown below.
     This OPTIONAL property describes whether http redirects should be disabled. If omitted,
     it is defaulted to false (so, per default, redirects are enabled).
 
+    It uses the consumer identity type wget with the fields
+    for a hostpath identity matcher (see [ocm get credentials](ocm_get_credentials.md)).
+
   Options used to configure fields: <code>--body</code>, <code>--header</code>, <code>--mediaType</code>, <code>--noredirect</code>, <code>--url</code>, <code>--verb</code>
 
 ### SEE ALSO