taigrr/nats.docs
1
0
Fork 0
mirror of https://github.com/taigrr/nats.docs synced 2025-01-18 04:03:23 -08:00
Code Issues Projects Releases Wiki Activity

Update services.md

Browse Source
This commit is contained in:
Ginger Collison 2019-10-18 10:13:22 -05:00 committed by GitHub
parent 964dd34f47
commit 299acb67de
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 10 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

24
nats-tools/nsc/services.md
View File

@ -48,13 +48,14 @@ To review the service export:
Importing a service enables you to send requests to the remote _Account_. To import a Service, you have to create an _Import_. To create an import you need to know: Importing a service enables you to send requests to the remote _Account_. To import a Service, you have to create an _Import_. To create an import you need to know:
* The exporting account’s public key - The exporting account’s public key
* The subject the service is listening on - The subject the service is listening on
* You can map the service’s subject to a different subject - You can map the service’s subject to a different subject
* Self-imports are not valid; you can only import services from other accounts. - Self-imports are not valid; you can only import services from other accounts.
To learn how to inspect a JWT from an account server, [check this article](../nas/inspecting_jwts.md). To learn how to inspect a JWT from an account server, [check this article](../nas/inspecting_jwts.md).
```text ```text
> nsc add import --src-account AC7PO3MREV26U3LFZFP5BN3HAI32X3PKLBRVMPAETLEHWPQEUG7EJY4H --remote-subject help --service > nsc add import --src-account AC7PO3MREV26U3LFZFP5BN3HAI32X3PKLBRVMPAETLEHWPQEUG7EJY4H --remote-subject help --service
Success! - added service import "help" Success! - added service import "help"
@ -98,7 +99,6 @@ Verifying our work:
To test the service, we can install the `nats-req` and `nats-rply` tools: To test the service, we can install the `nats-req` and `nats-rply` tools:
Set up a process to handle the request: Set up a process to handle the request:
```text ```text
> go get github.com/nats-io/nats.go/examples/nats-rply > go get github.com/nats-io/nats.go/examples/nats-rply
@ -107,7 +107,6 @@ Listening on [help]
``` ```
Send the request: Send the request:
```text ```text
> go get github.com/nats-io/nats.go/examples/nats-req > go get github.com/nats-io/nats.go/examples/nats-req
> nats-req -creds ~/.nkeys/Test/accounts/AccountB/users/userb.creds help me > nats-req -creds ~/.nkeys/Test/accounts/AccountB/users/userb.creds help me
@ -115,13 +114,11 @@ Published [help] : 'me'
``` ```
The service receives the request: The service receives the request:
```text ```text
[#1] Received on [help]: 'me'
``` ```
And the response is received by the requestor: And the response is received by the requestor:
```text ```text
Received [_INBOX.v6KAX0v1bu87k49hbg3dgn.StIGJF0D] : 'I will help' Received [_INBOX.v6KAX0v1bu87k49hbg3dgn.StIGJF0D] : 'I will help'
``` ```
@ -131,7 +128,6 @@ Received [_INBOX.v6KAX0v1bu87k49hbg3dgn.StIGJF0D] : 'I will help'
If you want to create a service that is only accessible to accounts you designate you can create a _private_ service. The export will be visible in your account, but subscribing accounts will require an authorization token that must be created by you and generated specifically for the requesting account. If you want to create a service that is only accessible to accounts you designate you can create a _private_ service. The export will be visible in your account, but subscribing accounts will require an authorization token that must be created by you and generated specifically for the requesting account.
Let’s create an account and user for our stream client: Let’s create an account and user for our stream client:
```text ```text
> nsc add account --name AccountB > nsc add account --name AccountB
Generated account key - private key stored “~/.nkeys/Test/accounts/AccountB/AccountB" Generated account key - private key stored “~/.nkeys/Test/accounts/AccountB/AccountB"
@ -268,6 +264,7 @@ As with streams, importing a private service is more natural than a public one b
╰─────────┴─────────┴─────────────────┴─────────┴─────────┴──────────────┴────────╯ ╰─────────┴─────────┴─────────────────┴─────────┴─────────┴──────────────┴────────╯
``` ```
### Testing the Private Service ### Testing the Private Service
Start the replier: Start the replier:
@ -277,22 +274,19 @@ Start the replier:
Listening on [help.>] Listening on [help.>]
``` ```
Send a request:
Send a request:
```text ```text
> nats-req -creds ~/.nkeys/Test/accounts/AccountB/users/userb.creds help me > nats-req -creds ~/.nkeys/Test/accounts/AccountB/users/userb.creds help me
Published [help] : 'me' Published [help] : 'me'
``` ```
The service receives the message: The service receives the message:
```text ```text
[#1] Received on [help.AAL5Q2B3SM]: 'me'
``` ```
The requester receives its response: The requester receives its response:
```text ```text
Received [_INBOX.N3IiqWbiAQfPoINCBpBrUM.ZjBNtkB3] : 'I will help' Received [_INBOX.N3IiqWbiAQfPoINCBpBrUM.ZjBNtkB3] : 'I will help'
``` ```