Generate attributes of OBJECT type

[mchoma]

Attributes of OBJECT are not generated, e.g. jwt [1]
Although in model it is described as

                   "jwt" => {
                            "type" => OBJECT,
                            "description" => "A token validator to be used in conjunction with a token-based realm that handles security tokens based on the JWT/JWS standard.",
                            "expressions-allowed" => false,
                            "required" => false,
                            "nillable" => true,
                            "value-type" => {
                                "issuer" => {
                                    "type" => LIST,
                                    "description" => "A list of strings representing the issuers supported by this configuration. During validation JWT tokens must have an \"iss\" claim that contains one of the values defined here.",
                                    "expressions-allowed" => true,
                                    "required" => false,
                                    "nillable" => true,
                                    "min-length" => 1L,
                                    "max-length" => 2147483647L,
                                    "value-type" => STRING
                                },
                                "audience" => {
                                    "type" => LIST,
                                    "description" => "A list of strings representing the audiences supported by this configuration. During validation JWT tokens must have an \"aud\" claim that contains one of the values defined here.",
                                    "expressions-allowed" => true,
                                    "required" => false,
                                    "nillable" => true,
                                    "min-length" => 1L,
                                    "max-length" => 2147483647L,
                                    "value-type" => STRING
                                },
                                "public-key" => {
                                    "type" => STRING,
                                    "description" => "A public key in PEM Format. During validation, if a public key is provided, signature will be verified based on the key you provided here.",
                                    "expressions-allowed" => true,
                                    "required" => false,
                                    "nillable" => true,
                                    "alternatives" => [
                                        "key-store",
                                        "certificate"
                                    ],
                                    "min-length" => 1L,
                                    "max-length" => 2147483647L
                                },
                                "key-store" => {
                                    "type" => STRING,
                                    "description" => "A key store from where the certificate with a public key should be loaded from.",
                                    "expressions-allowed" => false,
                                    "required" => false,
                                    "nillable" => true,
                                    "alternatives" => ["public-key"],
                                    "requires" => ["certificate"],
                                    "capability-reference" => "org.wildfly.security.key-store",
                                    "min-length" => 1L,
                                    "max-length" => 2147483647L
                                },
                                "certificate" => {
                                    "type" => STRING,
                                    "description" => "The name of the certificate with a public key to load from the key store.",
                                    "expressions-allowed" => true,
                                    "required" => false,
                                    "nillable" => true,
                                    "alternatives" => ["public-key"],
                                    "requires" => ["key-store"],
                                    "min-length" => 1L,
                                    "max-length" => 2147483647L
                                }
                            },
                            "access-type" => "read-write",
                            "storage" => "configuration",
                            "restart-required" => "all-services"
                        },

[1] https://wildscribe.github.io/WildFly/13.0/subsystem/elytron/token-realm/index.html#attr-jwt

[jamezp]

Sorry I've never noticed these issues before. I'll have to think of the best way to handle this. I'm not sure how it would work in the current display.

[bstansberry]

As part of any work on this, be sure to read https://docs.wildfly.org/32/Admin_Guide.html#description-of-an-attribute, particularly the 'value-type' entry. There are different flavors of OBJECT -- either the equivalent of Map<String, [some MDR type> or a complex object like the one in the issue description.

[jamezp]

It looks like there was an attempt to just use the object and label it as JSON. However, the data appears to be DMR and not JSON.

I'm not really sure what the best option is here. Attempting to do some kind of recursive output for complex objects seems like it might not display well. IMO it seems reasonable to output some standard JSON unless anyone else has a better idea.

[jmesnil]

In the Management API Reference generated when the feature is built, I'm working around by providing the "Raw DMR Model" of an attribute to comprehensively describe it.
So the jwt attribute, instead of having:

https://wildscribe.github.io/WildFly/13.0/subsystem/elytron/token-realm/index.html#attr-jwt

we now have

https://jmesnil.github.io/wildfly.github.io/38/feature-pack/doc/reference/subsystem/elytron/token-realm/index.html#jwt

where the "Raw DMR model" row displays the JSON representation of this attribute.

[jamezp]

That Raw DMR model looks good to me. For some things like https://jmesnil.github.io/wildfly.github.io/38/feature-pack/doc/reference/subsystem/logging/file-handler/index.html#filter it's a bit verbose, but I think that is okay.