pekko/akka-docs/rst/scala/http/routing-dsl/directives/header-directives/checkSameOrigin.rst
tjugo 0eda4075ef +htp #20535 add checkSameOrigin directive to HeaderDirectives (#20560)
*  #20535 add checkSameOrigin directive to WebSocketDirectives

* refactoring + add docs

* refactoring + cleanup in docs

* fix types and conversions in the InvalidOriginHeaderRejection

* simplify InvalidOriginHeaderRejection to InvalidOriginRejection
2016-06-02 11:58:20 +02:00

23 lines
769 B
ReStructuredText

.. _-checkSameOrigin-:
checkSameOrigin
===============
Signature
---------
.. includecode2:: /../../akka-http/src/main/scala/akka/http/scaladsl/server/directives/HeaderDirectives.scala
:snippet: checkSameOrigin
Description
-----------
Checks that request comes from the same origin. Extracts the ``Origin`` header value and verifies that allowed range
contains the obtained value. In the case of absent of the ``Origin`` header rejects with a ``MissingHeaderRejection``.
If the origin value is not in the allowed range rejects with an ``InvalidOriginHeaderRejection``
and ``StatusCodes.Forbidden`` status.
Example
-------
.. includecode2:: ../../../../code/docs/http/scaladsl/server/directives/HeaderDirectivesExamplesSpec.scala
:snippet: checkSameOrigin-0