24 lines
734 B
ReStructuredText
24 lines
734 B
ReStructuredText
.. _-extractClientIP-:
|
|
|
|
extractClientIP
|
|
===============
|
|
|
|
Signature
|
|
---------
|
|
|
|
.. includecode2:: /../../akka-http/src/main/scala/akka/http/scaladsl/server/directives/MiscDirectives.scala
|
|
:snippet: extractClientIP
|
|
|
|
Description
|
|
-----------
|
|
Provides the value of ``X-Forwarded-For``, ``Remote-Address``, or ``X-Real-IP`` headers as an instance of ``HttpIp``.
|
|
|
|
The akka-http server engine adds the ``Remote-Address`` header to every request automatically if the respective
|
|
setting ``akka.http.server.remote-address-header`` is set to ``on``. Per default it is set to ``off``.
|
|
|
|
Example
|
|
-------
|
|
|
|
.. includecode2:: ../../../../code/docs/http/scaladsl/server/directives/MiscDirectivesExamplesSpec.scala
|
|
:snippet: extractClientIP-example
|
|
|