:ref: rationalized user(s) credentials rest api endpoints

[dseurotech]

This pr rationalises file names, rest endpoints and openapi documentation for user (self-care) and users (admin managing credentials for users) credentials. In detail:

• All user self-care endpoints are not under /user/credentials (no point to prepend it with {scopeId} as the user's default scope will always be used)
• User is discouraged to reset hers own credentials
• All admin endpoints are now under /{scopeId}/users/credentials base path
• It is now possible to reset only password credentials (endpoints with [...]/{credentialId}/_reset have been deprecated)

All previous endpoints have been deprecated and marked for removal in the next version.

[codecov[bot]]

Codecov Report

Attention: Patch coverage is 15.38462% with 44 lines in your changes are missing coverage. Please review.

Project coverage is 21.09%. Comparing base (28a75ed) to head (af17dee).

Additional details and impacted files

[](https://app.codecov.io/gh/eclipse/kapua/pull/3977?src=pr&el=tree&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=eclipse) ```diff @@ Coverage Diff @@ ## develop #3977 +/- ## ============================================= + Coverage 21.08% 21.09% +0.01% Complexity 10 10 ============================================= Files 1941 1942 +1 Lines 41233 41252 +19 Branches 3791 3793 +2 ============================================= + Hits 8694 8704 +10 - Misses 32132 32142 +10 + Partials 407 406 -1 ``` | [Files](https://app.codecov.io/gh/eclipse/kapua/pull/3977?src=pr&el=tree&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=eclipse) | Coverage Δ | | |---|---|---| | [...se/kapua/app/api/resources/v1/resources/Users.java](https://app.codecov.io/gh/eclipse/kapua/pull/3977?src=pr&el=tree&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=eclipse#diff-cmVzdC1hcGkvcmVzb3VyY2VzL3NyYy9tYWluL2phdmEvb3JnL2VjbGlwc2Uva2FwdWEvYXBwL2FwaS9yZXNvdXJjZXMvdjEvcmVzb3VyY2VzL1VzZXJzLmphdmE=) | `0.00% <ø> (ø)` | | | [...ice/authentication/shiro/AuthenticationModule.java](https://app.codecov.io/gh/eclipse/kapua/pull/3977?src=pr&el=tree&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=eclipse#diff-c2VydmljZS9zZWN1cml0eS9zaGlyby9zcmMvbWFpbi9qYXZhL29yZy9lY2xpcHNlL2thcHVhL3NlcnZpY2UvYXV0aGVudGljYXRpb24vc2hpcm8vQXV0aGVudGljYXRpb25Nb2R1bGUuamF2YQ==) | `71.69% <ø> (ø)` | | | [...thentication/user/shiro/UserCredentialsModule.java](https://app.codecov.io/gh/eclipse/kapua/pull/3977?src=pr&el=tree&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=eclipse#diff-c2VydmljZS9zZWN1cml0eS9zaGlyby9zcmMvbWFpbi9qYXZhL29yZy9lY2xpcHNlL2thcHVhL3NlcnZpY2UvYXV0aGVudGljYXRpb24vdXNlci9zaGlyby9Vc2VyQ3JlZGVudGlhbHNNb2R1bGUuamF2YQ==) | `66.66% <100.00%> (+6.66%)` | :arrow_up: | | [...p/api/resources/v1/resources/UsersCredentials.java](https://app.codecov.io/gh/eclipse/kapua/pull/3977?src=pr&el=tree&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=eclipse#diff-cmVzdC1hcGkvcmVzb3VyY2VzL3NyYy9tYWluL2phdmEvb3JnL2VjbGlwc2Uva2FwdWEvYXBwL2FwaS9yZXNvdXJjZXMvdjEvcmVzb3VyY2VzL1VzZXJzQ3JlZGVudGlhbHMuamF2YQ==) | `0.00% <0.00%> (ø)` | | | [...pp/api/resources/v1/resources/UserCredentials.java](https://app.codecov.io/gh/eclipse/kapua/pull/3977?src=pr&el=tree&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=eclipse#diff-cmVzdC1hcGkvcmVzb3VyY2VzL3NyYy9tYWluL2phdmEvb3JnL2VjbGlwc2Uva2FwdWEvYXBwL2FwaS9yZXNvdXJjZXMvdjEvcmVzb3VyY2VzL1VzZXJDcmVkZW50aWFscy5qYXZh) | `0.00% <0.00%> (ø)` | | | [...cation/credential/shiro/CredentialServiceImpl.java](https://app.codecov.io/gh/eclipse/kapua/pull/3977?src=pr&el=tree&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=eclipse#diff-c2VydmljZS9zZWN1cml0eS9zaGlyby9zcmMvbWFpbi9qYXZhL29yZy9lY2xpcHNlL2thcHVhL3NlcnZpY2UvYXV0aGVudGljYXRpb24vY3JlZGVudGlhbC9zaGlyby9DcmVkZW50aWFsU2VydmljZUltcGwuamF2YQ==) | `6.25% <12.50%> (+0.29%)` | :arrow_up: | | [...ication/user/shiro/UserCredentialsServiceImpl.java](https://app.codecov.io/gh/eclipse/kapua/pull/3977?src=pr&el=tree&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=eclipse#diff-c2VydmljZS9zZWN1cml0eS9zaGlyby9zcmMvbWFpbi9qYXZhL29yZy9lY2xpcHNlL2thcHVhL3NlcnZpY2UvYXV0aGVudGljYXRpb24vdXNlci9zaGlyby9Vc2VyQ3JlZGVudGlhbHNTZXJ2aWNlSW1wbC5qYXZh) | `0.00% <0.00%> (ø)` | | | [...ication/credential/shiro/PasswordResetterImpl.java](https://app.codecov.io/gh/eclipse/kapua/pull/3977?src=pr&el=tree&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=eclipse#diff-c2VydmljZS9zZWN1cml0eS9zaGlyby9zcmMvbWFpbi9qYXZhL29yZy9lY2xpcHNlL2thcHVhL3NlcnZpY2UvYXV0aGVudGljYXRpb24vY3JlZGVudGlhbC9zaGlyby9QYXNzd29yZFJlc2V0dGVySW1wbC5qYXZh) | `21.42% <21.42%> (ø)` | | ... and [1 file with indirect coverage changes](https://app.codecov.io/gh/eclipse/kapua/pull/3977/indirect-changes?src=pr&el=tree-more&utm_medium=referral&utm_source=github&utm_content=comment&utm_campaign=pr+comments&utm_term=eclipse)