Skip to content

Commit b987802

Browse files
Merge pull request #235977 from ggailey777/patch-13
[Functions] Clean-up the admin APIs guidance
2 parents 5b193ee + b3c7e46 commit b987802

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. You can call the `functions` administrator endpoint (`http://localhost:{port}/admin/functions/`) to get URLs for all available functions, both HTTP triggered and non-HTTP triggered.
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)