<!-- 
RSS generated by JIRA (9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66) at Thu Feb 08 09:08:18 UTC 2024

It is possible to restrict the fields that are returned in this document by specifying the 'field' parameter in your request.
For example, to request only the issue key and summary append 'field=key&field=summary' to the URL of your request.
-->
<rss version="0.92" >
<channel>
    <title>MongoDB Jira</title>
    <link>https://jira.mongodb.org</link>
    <description>This file is an XML representation of an issue</description>
    <language>en-us</language>    <build-info>
        <version>9.7.1</version>
        <build-number>970001</build-number>
        <build-date>13-04-2023</build-date>
    </build-info>


<item>
            <title>[MONGOCRYPT-249] KMS instructions in integration guide unclear</title>
                <link>https://jira.mongodb.org/browse/MONGOCRYPT-249</link>
                <project id="17481" key="MONGOCRYPT">Libmongocrypt</project>
                    <description>&lt;p&gt;The kms instructions (&lt;a href=&quot;https://github.com/mongodb/libmongocrypt/blob/master/integrating.md#state-mongocrypt_ctx_need_kms&quot; class=&quot;external-link&quot; target=&quot;_blank&quot; rel=&quot;nofollow noopener&quot;&gt;https://github.com/mongodb/libmongocrypt/blob/master/integrating.md#state-mongocrypt_ctx_need_kms&lt;/a&gt;) state that the driver is to iterate context and for each context:&lt;/p&gt;

&lt;p&gt;1. create a tls socket&lt;br/&gt;
2. Write the message from mongocrypt_kms_ctx_message to the &amp;gt; socket.&lt;br/&gt;
3. Feed the reply back with mongocrypt_kms_ctx_feed. Repeat &amp;gt; until mongocrypt_kms_ctx_bytes_needed returns 0.&lt;/p&gt;

&lt;p&gt;The last bullet point is unclear as to what it requires:&lt;/p&gt;

&lt;p&gt;1. What is &quot;the reply&quot; and how was it obtained?&lt;br/&gt;
2. When should the driver call mongocrypt_kms_ctx_bytes_needed and how is this return value used?&lt;/p&gt;

&lt;p&gt;Looking at the Python driver, what it does appears to be:&lt;/p&gt;

&lt;p&gt;1. create a tls socket&lt;br/&gt;
2. write the message&lt;br/&gt;
3. call mongocrypt_kms_ctx_bytes_needed to get the maximum number of bytes that LMC would like to receive&lt;br/&gt;
4. if the number of bytes needed is zero, stop&lt;br/&gt;
5. read up to that many bytes from the socket&lt;br/&gt;
6. pass the read bytes (generally fewer than the value returned by mongocrypt_kms_ctx_bytes_needed) to LMC&lt;br/&gt;
7. go to step 3&lt;/p&gt;

&lt;p&gt;If these are the required steps, I suggest incorporating them into the integration guide as a replacement for the current procedure.&lt;/p&gt;</description>
                <environment></environment>
        <key id="1139873">MONGOCRYPT-249</key>
            <summary>KMS instructions in integration guide unclear</summary>
                <type id="1" iconUrl="https://jira.mongodb.org/secure/viewavatar?size=xsmall&amp;avatarId=14703&amp;avatarType=issuetype">Bug</type>
                                            <priority id="3" iconUrl="https://jira.mongodb.org/images/icons/priorities/major.svg">Major - P3</priority>
                        <status id="10038" iconUrl="https://jira.mongodb.org/images/icons/subtask.gif" description="">Backlog</status>
                    <statusCategory id="2" key="new" colorName="default"/>
                                    <resolution id="-1">Unresolved</resolution>
                                        <assignee username="-1">Unassigned</assignee>
                                    <reporter username="oleg.pudeyev@mongodb.com">Oleg Pudeyev</reporter>
                        <labels>
                    </labels>
                <created>Fri, 7 Feb 2020 23:20:18 +0000</created>
                <updated>Wed, 30 Mar 2022 21:21:25 +0000</updated>
                                                                            <component>Documentation</component>
                                        <votes>0</votes>
                                    <watches>1</watches>
                                                                                                                    <issuelinks>
                            <issuelinktype id="10012">
                    <name>Related</name>
                                            <outwardlinks description="related to">
                                        <issuelink>
            <issuekey id="1518599">MONGOCRYPT-286</issuekey>
        </issuelink>
                            </outwardlinks>
                                                        </issuelinktype>
                    </issuelinks>
                <attachments>
                    </attachments>
                <subtasks>
                    </subtasks>
                <customfields>
                                                                                                                                                                                                                                                                                                            <customfield id="customfield_15850" key="com.atlassian.jira.plugins.jira-development-integration-plugin:devsummary">
                        <customfieldname>Development</customfieldname>
                        <customfieldvalues>
                            
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            <customfield id="customfield_12550" key="com.pyxis.greenhopper.jira:gh-lexo-rank">
                        <customfieldname>Rank</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>2|hr6nf3:</customfieldvalue>

                        </customfieldvalues>
                    </customfield>
                                                                <customfield id="customfield_10558" key="com.pyxis.greenhopper.jira:gh-global-rank">
                        <customfieldname>Rank (Obsolete)</customfieldname>
                        <customfieldvalues>
                            <customfieldvalue>9223372036854775807</customfieldvalue>
                        </customfieldvalues>
                    </customfield>
                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                </customfields>
    </item>
</channel>
</rss>