Skip to content

Latest commit

 

History

History
42 lines (27 loc) · 1.56 KB

README.md

File metadata and controls

42 lines (27 loc) · 1.56 KB
Raw

Greengrass EMQX Authentication/Authorization Plugin

This repository hosts a plugin and build system for Greengrass's aws.greengrass.clientdevices.mqtt.EMQX component.

Building

To build EMQX with the Greengrass authentication and authorization plugin, install:

  • python3
  • cmake
  • Erlang/OTP
  • Native buildtools (gcc/clang/msvc)

See Dockerfile for a full list of requirements (for Alpine Linux at least).

Run python3 -u -m bin in order to build everything. The built EMQX will be in /build as emqx.zip.

Build Options

python3 -u -m bin has several options when building. The default (no options) will build everything and execute tests.

  • Use --no-test to skip testing.
  • Use --quick to build only the EMQX auth plugin. Must perform a full build first.
  • Use --sdk-only to build only the AWS IoT Device SDK for C++.
  • Use --emqx-only to build only EMQX.
  • Use --port-driver-only to build only the native port driver.
  • Use --test-only to only rebuild and test the EMQX auth plugin. Must perform a full build first.
  • Use --no-sdk to skip building the AWS IoT Device SDK for C++.

Security

See CONTRIBUTING for more information.

License

This project is licensed under the Apache-2.0 License.

Distribution

This software includes code distributed under the Microsoft Software License Terms - Microsoft Visual Studio Community 2022. By downloading this software, you agree to that code's license terms, which can be found here