Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

kbs: ITA: Documentation update. #675

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

szymon-klimek
Copy link

@szymon-klimek szymon-klimek commented Jan 23, 2025

Documentation of parameters policy_ids and allow_unmatched_policy updated to be more descriptive.

@szymon-klimek szymon-klimek requested a review from a team as a code owner January 23, 2025 14:23
Copy link
Member

@fitzthum fitzthum left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I guess the DCO is complaining because your sign-off doesn't match the name in the "from" field of your patch (which is lowercase). Can you tweak that please. Otherwise seems ok.

cc @mythi

@szymon-klimek szymon-klimek force-pushed the sklimek/change_default_policy_ids_behavior branch from 058279c to 7cd9fc3 Compare January 24, 2025 10:34
@szymon-klimek szymon-klimek changed the title kbs: ITA: Default behavior for policy_ids changed. kbs: ITA: Documentation update. Jan 24, 2025
Documentation of parameters `policy_ids` and `allow_unmatched_policy` updated to be more descriptive.

Signed-off-by: szymon.klimek <[email protected]>
@szymon-klimek szymon-klimek force-pushed the sklimek/change_default_policy_ids_behavior branch from 7cd9fc3 to 617943f Compare January 24, 2025 10:59
@szymon-klimek
Copy link
Author

I guess the DCO is complaining because your sign-off doesn't match the name in the "from" field of your patch (which is lowercase). Can you tweak that please. Otherwise seems ok.

cc @mythi

After contacting @mythi I revoked the changes and only updated documentation.

| `api_key` | String | Intel Trust Authority API key. | Yes | - |
| `certs_file` | String | URL to an Intel Trust Authority portal or path to JWKS file used for token verification. | Yes | - |
| `policy_ids` | String array | Quoted and comma-separated list of policy IDs defined in ITA portal. | No | `[]` |
| `allow_unmatched_policy` | Boolean | If `policy_ids` is not specified, parameter is ignored and ignores result of policy matching. <br/> Otherwise, define whether result of policy matching should be ignored. | No | false |
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
| `allow_unmatched_policy` | Boolean | If `policy_ids` is not specified, parameter is ignored and ignores result of policy matching. <br/> Otherwise, define whether result of policy matching should be ignored. | No | false |
| `allow_unmatched_policy` | Boolean | If `policy_ids` is empty, this setting is ignored. By default, the listed policies must always match. Enabling this flag relaxes that requirement. | No | false |

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In my opinion By default here is misleading, beacuse by default policy_ids are empty

so the true default behavior is that policies does not have to match

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants