docs-site icon indicating copy to clipboard operation
docs-site copied to clipboard

Doc enhancement request for docs.zowe.org/stable/user-guide/initialize-security-configuration/ tls1.2/tls 1.3

Open colinpaicemq opened this issue 10 months ago • 2 comments

Is your request for enhancement related to a problem? Please describe.

I am trying to configure zowe so it supports 1.2 and not 1.3, (so I can use wireshark to look at the flows)

Describe the solution you'd like

A description somwhere, of what options I need to specify. Presumably in the zowe.yaml.

I can see from the schema there is

"maxTls": { "type": "string", "enum": ["TLSv1.2", "TLSv1.3"], "default": "TLSv1.3", "description": "Maximum TLS version allowed for network connections." },

but this is not documented in pages like https://docs.zowe.org/stable/appendix/zowe-yaml-configuration/

Related doc pages

Additional context

colinpaicemq avatar Jan 09 '25 19:01 colinpaicemq

We already have a related issue here - https://github.com/zowe/docs-site/issues/3775

balhar-jakub avatar Jan 29 '25 13:01 balhar-jakub

I hope you'll be happy to see a long awaited document that describes this is now live as of today. https://docs.zowe.org/stable/user-guide/tls-configuration right next to it is AT-TLS, both will give you the TLS customization you need.

the YAML appendix is quite old and I don't think it is maintainable in the sense that as we add new features we'll need to update it and it will grow and grow. I think the YAML appendix should instead stick to explaining basic concepts: how does one use the YAMLs in general?

1000TurquoisePogs avatar Feb 04 '25 20:02 1000TurquoisePogs