diff --git a/content/community.md b/content/community.md index f3143a7..4550d0a 100644 --- a/content/community.md +++ b/content/community.md @@ -2,4 +2,4 @@ Using 3scale is a great way to build real-world enterprise applications based on the latest technologies. But what if you find something that needs fixing or have a new feature to suggest? By getting involved with the 3scale community you can give feedback, improve the docs, review code and discuss and propose new features whenever they’re needed. Answering user questions or taking part in development discussions is also a great way to build a reputation for collaboration and expertise in your field. -No matter what your skill level, contributing to 3scle can be very rewarding and a great learning experience. You’ll meet lots of smart, passionate developers who are all driven to create the best middleware possible in open source! You don’t have to be an expert to get involved and it doesn’t have to take a lot of time. +No matter what your skill level, contributing to 3scale can be very rewarding and a great learning experience. You’ll meet lots of smart, passionate developers who are all driven to create the best middleware possible in open source! You don’t have to be an expert to get involved and it doesn’t have to take a lot of time. diff --git a/content/tutorials/deploy-apicast.md b/content/tutorials/deploy-apicast.md index 753455a..dbb6d62 100644 --- a/content/tutorials/deploy-apicast.md +++ b/content/tutorials/deploy-apicast.md @@ -1,5 +1,8 @@ # Deploy APIcast +In this tutorial, you will learn how to deploy APIcast (the Red Hat API Gateway) +to protect your APIs. + ## 1) Get a token to access the Red Hat Registry You will need to create a token to be able to fetch APIcast from the Red Hat registry. Go to [access.redhat.com/terms-based-registry](https://access.redhat.com/terms-based-registry/), log in with your developer account (if you have not already done so), and click "New Service Account." @@ -64,18 +67,24 @@ docker run -it --rm --name apicast -p 8080:8080 -e APICAST_CONFIGURATION_CACHE=0 Confirm APIcast is working with: ```raw -$ curl -H "api-key: 123456" http://localhost:8080/echo +$ curl -H "api-key: dummy" http://localhost:8080/echo GET /test HTTP/1.1 X-Real-IP: 172.17.0.1 Host: echo User-Agent: curl/7.54.0 Accept: */* -api-key: 123456 +api-key: dummy ``` +At this time, APIcast is performing: + +- **Routing**: requests coming for `localhost` are proxified to an "echo" service. Other requests are dismissed. +- **Filtering** allowed paths and methods: `GET` requests starting with `/` are allowed. Other requests are dismissed. +- **Policy application**: the built-in `apicast` policy is applied. You could add other policies to manage HTTP headers, enforce access control, etc. + ## 3) Protect your APIs with APIcast -Update the configuration file for APIcast: +Update the configuration file for APIcast to forward requests to another API backend: ```json cat > config.json < config.json <