From bc6b5b009047f71e3ad67967059536410f1906a9 Mon Sep 17 00:00:00 2001 From: Steve Kim <86316075+sbSteveK@users.noreply.github.com> Date: Mon, 14 Oct 2024 10:50:12 -0700 Subject: [PATCH] move mac-only tls info to main README (#599) --- README.md | 9 +++++++++ documents/FAQ.md | 9 --------- 2 files changed, 9 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index 343c0e6d..b0ba6762 100644 --- a/README.md +++ b/README.md @@ -7,6 +7,7 @@ This document provides information about the AWS IoT device SDK for Java V2. Thi * [Installation](#installation) * [Android](./documents/ANDROID.md) * [Samples](samples) +* [Mac-Only TLS Behavior](#mac-only-tls-behavior) * [Getting Help](#getting-help) * [FAQ](./documents/FAQ.md) * [API Docs](https://aws.github.io/aws-iot-device-sdk-java-v2/) @@ -71,6 +72,14 @@ mvn versions:use-latest-versions -Dincludes="software.amazon.awssdk.crt*" [Samples README](samples) +### Mac-Only TLS Behavior + +Please note that on Mac, once a private key is used with a certificate, that certificate-key pair is imported into the Mac Keychain. All subsequent uses of that certificate will use the stored private key and ignore anything passed in programmatically. Beginning in v1.7.3, when a stored private key from the Keychain is used, the following will be logged at the "info" log level: + +``` +static: certificate has an existing certificate-key pair that was previously imported into the Keychain. Using key from Keychain instead of the one provided. +``` + ## Getting Help The best way to interact with our team is through GitHub. You can open a [discussion](https://github.com/aws/aws-iot-device-sdk-java-v2/discussions) for guidance questions or an [issue](https://github.com/aws/aws-iot-device-sdk-java-v2/issues/new/choose) for bug reports, or feature requests. You may also find help on community resources such as [StackOverFlow](https://stackoverflow.com/questions/tagged/aws-iot) with the tag [#aws-iot](https://stackoverflow.com/questions/tagged/aws-iot) or if you have a support plan with [AWS Support](https://aws.amazon.com/premiumsupport/), you can also create a new support case. diff --git a/documents/FAQ.md b/documents/FAQ.md index de334eed..da696ae5 100644 --- a/documents/FAQ.md +++ b/documents/FAQ.md @@ -5,7 +5,6 @@ * [How do I enable logging](#how-do-i-enable-logging) * [I keep getting AWS_ERROR_MQTT_UNEXPECTED_HANGUP](#i-keep-getting-aws_error_mqtt_unexpected_hangup) * [I am experiencing deadlocks](#i-am-experiencing-deadlocks) -* [Mac-Only TLS Behavior](#mac-only-tls-behavior) * [How do debug in VSCode?](#how-do-debug-in-vscode) * [What certificates do I need?](#what-certificates-do-i-need) * [How do I build and use the Android SDK?](#how-do-i-build-and-use-the-android-sdk) @@ -64,14 +63,6 @@ After getting it working make sure to only allow the actions and resources that You MUST NOT perform blocking operations on any callback, or you will cause a deadlock. For example: in the on_publish_received callback, do not send a publish, and then wait for the future to complete within the callback. The Client cannot do work until your callback returns, so the thread will be stuck. -### Mac-Only TLS Behavior - -Please note that on Mac, once a private key is used with a certificate, that certificate-key pair is imported into the Mac Keychain. All subsequent uses of that certificate will use the stored private key and ignore anything passed in programmatically. Beginning in v1.7.3, when a stored private key from the Keychain is used, the following will be logged at the "info" log level: - -``` -static: certificate has an existing certificate-key pair that was previously imported into the Keychain. Using key from Keychain instead of the one provided. -``` - ### How do debug in VSCode? Here is an example launch.json file to run the pubsub sample