2016-06-28 18:53:10 +03:00
|
|
|
# Mongoose - Embedded Web Server / Embedded Networking Library
|
2012-08-25 22:48:14 +01:00
|
|
|
|
2021-05-04 13:46:44 +01:00
|
|
|
[](https://opensource.org/licenses/gpl-2.0.php)
|
2020-12-18 11:32:59 +00:00
|
|
|
[](https://github.com/cesanta/mongoose/actions)
|
2020-12-07 08:08:21 +00:00
|
|
|
[](https://codecov.io/gh/cesanta/mongoose)
|
2021-01-05 18:10:01 +00:00
|
|
|
[](https://bugs.chromium.org/p/oss-fuzz/issues/list?sort=-opened&can=1&q=proj:mongoose)
|
2014-04-09 18:10:49 +01:00
|
|
|
|
2020-12-06 21:12:05 +00:00
|
|
|
Mongoose is a networking library for C/C++. It implements event-driven
|
2021-05-04 13:46:44 +01:00
|
|
|
non-blocking APIs for TCP, UDP, HTTP, WebSocket, MQTT. It is designed for
|
|
|
|
|
connecting devices and bringing them online. On the market since 2004, used by
|
|
|
|
|
vast number of open source and commercial products - it even runs on the
|
2020-12-06 21:12:05 +00:00
|
|
|
International Space Station! Mongoose makes embedded network programming fast,
|
2021-05-04 13:46:44 +01:00
|
|
|
robust, and easy. Features include:
|
|
|
|
|
|
|
|
|
|
- Cross-platform: works on Linux/UNIX, MacOS, Windows, Android, FreeRTOS, etc
|
|
|
|
|
- Supported embedded architectures: ESP32, NRF52, STM32, NXP, and more
|
|
|
|
|
- Builtin protocols: plain TCP/UDP, HTTP, MQTT, Websocket
|
|
|
|
|
- SSL/TLS support: mbedTLS, OpenSSL or custom (via API)
|
|
|
|
|
- Asynchronous DNS resolver
|
|
|
|
|
- Tiny static and run-time footprint
|
|
|
|
|
- Source code is both ISO C and ISO C++ compliant
|
|
|
|
|
- Very easy to integrate: just copy `mongoose.c` and `mongoose.h` files to your build tree
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
# Commercial use
|
|
|
|
|
- Mongoose is used by hundreds of businesses, from Fortune 500 giants like
|
2021-05-04 16:54:16 +01:00
|
|
|
Siemens, Bosch, Google, Samsung, Qualcomm, Caterpillar - to tiny startups
|
2021-05-04 13:46:44 +01:00
|
|
|
- Used to solve a wide range of business needs, like implementing Web UI
|
|
|
|
|
interface on devices, RESTful API services, telemetry data exchange, remote
|
|
|
|
|
control for a product, remote software updates, remote monitoring, and others
|
2021-05-04 16:54:16 +01:00
|
|
|
- Deployed to hundreds of millions devices in production environment worldwide
|
2021-05-04 13:46:44 +01:00
|
|
|
- See [Case Studies](https://cesanta.com/case-studies.html) from our respected
|
2021-05-04 16:54:16 +01:00
|
|
|
customers like Schneider Electric (industrial automation), Schenck Process
|
|
|
|
|
(industrial engineering), and others
|
2021-05-04 13:46:44 +01:00
|
|
|
- See [Testimonials](https://cesanta.com/testimonials.html) from engineers that
|
|
|
|
|
integrated Mongoose in their commercial products
|
|
|
|
|
- We provide [commercial licensing](https://cesanta.com/licensing.html),
|
|
|
|
|
[support](https://cesanta.com/support.html), consultancy and integration
|
2021-05-04 13:53:17 +01:00
|
|
|
assistance - don't hesitate to
|
|
|
|
|
[contact us](https://www.cesanta.com/contact.html)
|
2021-05-04 13:46:44 +01:00
|
|
|
|
|
|
|
|
|
|
|
|
|
# Security
|
|
|
|
|
|
|
|
|
|
We take security seriously:
|
|
|
|
|
1. Mongoose repository runs a
|
|
|
|
|
[continuous integration test powered by GitHub](https://github.com/cesanta/mongoose/actions),
|
|
|
|
|
which runs through hundreds of unit tests on every commit to the repository.
|
|
|
|
|
Our [unit tests](https://github.com/cesanta/mongoose/tree/master/test)
|
|
|
|
|
are built with modern address sanitizer technologies, which help to find
|
|
|
|
|
security vulnerabilities early
|
|
|
|
|
2. Mongoose repository is integrated into Google's
|
|
|
|
|
[oss-fuzz continuous fuzzer](https://bugs.chromium.org/p/oss-fuzz/issues/list?sort=-opened&can=1&q=proj:mongoose)
|
|
|
|
|
which scans for potential vulnerabilities continuously
|
|
|
|
|
3. We receive periodic vulnerability reports from the independent security
|
|
|
|
|
groups like
|
|
|
|
|
[Cisco Talos](https://www.cisco.com/c/en/us/products/security/talos.html),
|
|
|
|
|
[Microsoft Security Response Center](https://www.microsoft.com/en-us/msrc),
|
|
|
|
|
[MITRE Corporation](https://www.mitre.org/),
|
|
|
|
|
[Compass Security](https://www.compass-security.com/en/) and others.
|
|
|
|
|
In case of the vulnerability found, we act according to the industry best
|
|
|
|
|
practice: hold on to the publication, fix the software and notify all our
|
2021-05-04 13:55:45 +01:00
|
|
|
customers that have an appropriate subscription
|
2021-05-04 13:46:44 +01:00
|
|
|
4. Some of our customers (for example, NASA)
|
|
|
|
|
have specific security requirements and run independent security audits,
|
|
|
|
|
of which we get notified and in case of any issue, act similar to (3).
|
|
|
|
|
|
|
|
|
|
# Supplement software
|
|
|
|
|
|
|
|
|
|
This software is often used together with Mongoose:
|
|
|
|
|
- [mjson](https://github.com/cesanta/mjson) - a JSON parser. Used to implement
|
|
|
|
|
RESTful APIs that use JSON, or implement data exchange (e.g. over MQTT
|
|
|
|
|
or Websocket) that use JSON for data encapsulation
|
|
|
|
|
- [elk](https://github.com/cesanta/elk) - a tiny JavaScript interpreter.
|
|
|
|
|
Used to implement scripting support for customers
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
# Precompiled web server binary
|
|
|
|
|
|
|
|
|
|
We have built a ready-to-go, precompiled web server binary for Windows
|
|
|
|
|
and Mac. It is a great tool for sharing your files or website. It has
|
|
|
|
|
a unique feature - an ability to share your local files via a global URL.
|
|
|
|
|
|
|
|
|
|
Interested? Go to [donwload](https://mongoose.ws/)
|
2014-03-11 16:59:17 +00:00
|
|
|
|
2016-03-01 10:41:24 +00:00
|
|
|
# Contributions
|
|
|
|
|
|
2020-02-13 10:20:05 +00:00
|
|
|
Contributions are welcome! Please follow the guidelines below:
|
|
|
|
|
|
|
|
|
|
- Sign [Cesanta CLA](https://cesanta.com/cla.html) and send GitHub pull request
|
2021-05-04 13:46:44 +01:00
|
|
|
- Make sure that PRs have only one commit, and deal with one issue only
|
