dimas-b opened a new pull request, #211:
URL: https://github.com/apache/polaris/pull/211

   # Description
   
   Iceberg REST API spec defines two possible values for the 
`X-Iceberg-Access-Delegation`:
   * vended-credentials
   * remote-signing
   
   This change fixes Polaris docs to use the `vended-credentials` value instead 
of previous (incorrect) value of `true` and makes the REST API service validate 
the `X-Iceberg-Access-Delegation` header submitted by the client against the 
spec.
   
   Note: since old docs suggested invalid `X-Iceberg-Access-Delegation` header 
values (the string `true`), clients configured according to the old docs will 
_not_ be able to connect to the updated servers. Technically this is a breaking 
change, but it is necessary to align to the REST API spec. The old suggested 
value of `true` cannot be interpreted according to the spec, so it will result 
in error responses to the misconfigured clients.
   
   Detailed changes:
   
   * Add `AccessDelegationMode` enum to parse and represent specified
     delegation modes in java.
       
   * Update `IcebergCatalogAdapter` to validate that if access
     delegation is supported by the client, that "vended-credentials"
     is accepted ("remote-signing" is not supported by the server).
       
   * Remove unused method parameters.
   
   * Re-generate docs
   
   ## Type of change
   
   Please delete options that are not relevant.
   
   - [x] Bug fix (non-breaking change which fixes an issue)
   - [x] Documentation update
   - [ ] New feature (non-breaking change which adds functionality)
   - [x] Breaking change (fix or feature that would cause existing 
functionality to not work as expected)
   - [x] This change requires a documentation update
   
   # How Has This Been Tested?
   
   Existing and new unit tests
   
   # Checklist:
   
   Please delete options that are not relevant.
   
   - [x] I have performed a self-review of my code
   - [x] I have commented my code, particularly in hard-to-understand areas
   - [x] I have made corresponding changes to the documentation


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]

Reply via email to