Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Restructuring #1459

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
38 changes: 19 additions & 19 deletions distribution/examples/README.md

Large diffs are not rendered by default.

File renamed without changes.
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ docker run -d --name jaeger -e COLLECTOR_OTLP_ENABLED=true -p 16686:16686 -p 431
5. Open `localhost:16686` in the browser to access the Jaeger UI.
6. Select Membrane as the service and click on `Find Traces`.
A span created by Membrane should be visible in [Jaeger UI](http://localhost:16686).
![sample](./resources/otel_sample.png)
![sample](resources/otel_sample.png)
7. Examine the printed header fields on the console. You will see headers called `traceparent`, these denote which spans were involved in the request.

**HOW IT IS DONE**
Expand Down
File renamed without changes.
Empty file.
File renamed without changes.
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ This tutorial shows how to use Membrane API Gateway to validate Json Web Tokens

Membrane API Gateway protects the Backend API.

![Overview](./images/00-overview.png)
![Overview](images/00-overview.png)

1. The client retrieves the token from Azure AD.
2. The JWT is issued by Azure AD and returned to the client
Expand All @@ -26,7 +26,7 @@ Both the Client and the Backend are registered in Azure AD with an "App registra
5. Choose ``New registration``.
6. Enter a name (e.g. ``Demo Backend``) and click ``Register``.

![Backend Registration](./images/01-backend-registration.png)
![Backend Registration](images/01-backend-registration.png)

7. Next to *Application ID URI*, click on ``Add an Application ID URI``.
8. Next to *Application ID URI*, click on ``Set``.
Expand All @@ -47,7 +47,7 @@ There are several possibilities of getting a valid token. For this demo, we use
1. Open https://aad.portal.azure.com/#view/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/~/RegisteredApps .
2. Choose ``New registration``.
3. Enter a name (e.g. ``Demo Client``) and click ``Register``.
![Client Registration](./images/03-client-registration.png)
![Client Registration](images/03-client-registration.png)

4. Take note of your ``Application (client) ID``.
5. Next to *Client credentials*, click on ``Add a certificate or secret``.
Expand All @@ -58,11 +58,11 @@ There are several possibilities of getting a valid token. For this demo, we use
9. Take note of the ``Value``, also known as the ``client secret``.
10. Click on ``API permissions``.
11. Click on ``Add a permission``.
![Adding a permission](./images/05-client-permission-granting.png)
![Adding a permission](images/05-client-permission-granting.png)
13. Below ``My APIs``, choose ``Demo Backend``.
![Adding a permission](./images/06-client-permission-granting2.png)
![Adding a permission](images/06-client-permission-granting2.png)
14. Select the ``ReadWrite`` permission.
![Adding a permission](./images/07-client-permission-granting3.png)
![Adding a permission](images/07-client-permission-granting3.png)
15. Click on ``Add permission``.

### 2.b. Get a token
Expand Down
Original file line number Diff line number Diff line change
@@ -1,16 +1,16 @@
<spring:beans xmlns="http://membrane-soa.org/proxies/1/"
xmlns:spring="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
http://membrane-soa.org/proxies/1/ http://membrane-soa.org/schemas/proxies-1.xsd">
<router>
<api port="2000">
<rateLimiter requestLimit="3" requestLimitDuration="PT30S"/>
<target host="www.google.de" port="80" />
</api>
</router>
</spring:beans>
<spring:beans xmlns="http://membrane-soa.org/proxies/1/"
xmlns:spring="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
http://membrane-soa.org/proxies/1/ http://membrane-soa.org/schemas/proxies-1.xsd">

<router>

<api port="2000">
<rateLimiter requestLimit="3" requestLimitDuration="PT30S"/>
<target host="www.google.de" port="80" />
</api>

</router>

</spring:beans>
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
Original file line number Diff line number Diff line change
@@ -1,18 +1,18 @@
@echo off
if not "%MEMBRANE_HOME%" == "" goto homeSet
set "MEMBRANE_HOME=%cd%\..\.."
echo "%MEMBRANE_HOME%"
if exist "%MEMBRANE_HOME%\service-proxy.bat" goto homeOk
:homeSet
if exist "%MEMBRANE_HOME%\service-proxy.bat" goto homeOk
echo Please set the MEMBRANE_HOME environment variable to point to
echo the directory where you have extracted the Membrane software.
exit
:homeOk
set "CLASSPATH=%MEMBRANE_HOME%"
set "CLASSPATH=%MEMBRANE_HOME%/conf"
set "CLASSPATH=%CLASSPATH%;%MEMBRANE_HOME%/starter.jar"
echo Membrane Router running...
@echo off
if not "%MEMBRANE_HOME%" == "" goto homeSet
set "MEMBRANE_HOME=%cd%\..\.."
echo "%MEMBRANE_HOME%"
if exist "%MEMBRANE_HOME%\service-proxy.bat" goto homeOk

:homeSet
if exist "%MEMBRANE_HOME%\service-proxy.bat" goto homeOk
echo Please set the MEMBRANE_HOME environment variable to point to
echo the directory where you have extracted the Membrane software.
exit

:homeOk
set "CLASSPATH=%MEMBRANE_HOME%"
set "CLASSPATH=%MEMBRANE_HOME%/conf"
set "CLASSPATH=%CLASSPATH%;%MEMBRANE_HOME%/starter.jar"
echo Membrane Router running...
java -classpath "%CLASSPATH%" com.predic8.membrane.core.Starter -c proxies.xml
Loading