Skip to content

Commit d595724

Browse files
authored
Clean-up the admin APIs guidance
1 parent 810bce3 commit d595724

File tree

1 file changed

+6
-5
lines changed

1 file changed

+6
-5
lines changed

articles/azure-functions/functions-run-local.md

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -460,7 +460,12 @@ You can make GET requests from a browser passing data in the query string. For a
460460

461461
#### Non-HTTP triggered functions
462462

463-
For all functions other than HTTP and Event Grid triggers, you can test your functions locally using REST by calling a special endpoint called an _administration endpoint_. Calling this endpoint with an HTTP POST request on the local server triggers the function.
463+
For all functions other than HTTP and Event Grid triggers, you can test your functions locally using REST by calling a special endpoint called an _administration endpoint_. Calling this endpoint with an HTTP POST request on the local server triggers the function. The administrator endpoint provides a list of all (HTTP triggered and non-HTTP triggered) functions on `http://localhost:{port}/admin/functions/`.
464+
465+
When running locally, authentication and authorization is bypassed. However, when you try to call the same administrator endpoints on your function app in Azure, you must provide an access key. To learn more, see [Function access keys](functions-bindings-http-webhook-trigger.md#authorization-keys).
466+
467+
>[!IMPORTANT]
468+
>Access keys are valuable shared secrets. When used locally, they must be securely stored outside of source control. Because authentication and authorization isn't required by Functions when running locally, you should avoid using and storing access keys unless your scenarios require it.
464469
465470
To test Event Grid triggered functions locally, see [Local testing with viewer web app](event-grid-how-tos.md#local-testing-with-viewer-web-app).
466471

@@ -492,10 +497,6 @@ curl --request POST -H "Content-Type:application/json" --data "{'input':'sample
492497
```
493498
---
494499

495-
The administrator endpoint also provides a list of all (HTTP triggered and non-HTTP triggered) functions on `http://localhost:{port}/admin/functions/`.
496-
497-
When you call an administrator endpoint on your function app in Azure, you must provide an access key. To learn more, see [Function access keys](functions-bindings-http-webhook-trigger.md#authorization-keys).
498-
499500
## <a name="publish"></a>Publish to Azure
500501

501502
The Azure Functions Core Tools supports two types of deployment:

0 commit comments

Comments
 (0)