index.rst 1.8 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364
  1. :Release: |release|
  2. :Date: |today|
  3. About SAML 2.0
  4. ==============
  5. SAML 2.0 or Security Assertion Markup Language 2.0 is a version of the SAML standard for exchanging authentication and authorization data between security domains.
  6. About PySAML2
  7. =============
  8. PySAML2 is a pure python implementation of SAML2. It contains all
  9. necessary pieces for building a SAML2 service provider or an identity provider.
  10. The distribution contains examples of both.
  11. Originally written to work in a WSGI environment, there are extensions that
  12. allow you to use it with other frameworks.
  13. How to use PySAML2
  14. ===================
  15. Before you can use Pysaml2, you'll need to get it installed.
  16. If you have not done it yet, read the :ref:`install`
  17. Well, now you have it installed, and you want to do something.
  18. And I'm sorry to tell you this, but there isn't really a lot you can do with
  19. this code on it's own.
  20. Sure you can send a AuthenticationRequest to an IdentityProvider or an
  21. AttributeQuery to an AttributeAuthority but in order to get what they
  22. return you have to sit behind a Web server. Well, that is not really true since
  23. the AttributeQuery would be over SOAP and you would get the result over the
  24. connection you have to the AttributeAuthority.
  25. But anyway, you may get my point. This is middleware stuff!
  26. PySAML2 is built to fit into a
  27. `WSGI <http://www.python.org/dev/peps/pep-0333/>`_ application
  28. But it can be used in a non-WSGI environment too.
  29. So you will find descriptions of both cases here.
  30. The configuration is the same disregarding whether you are using PySAML2 in a
  31. WSGI or non-WSGI environment.
  32. Table of contents
  33. ==================
  34. .. toctree::
  35. :maxdepth: 2
  36. install
  37. examples/index
  38. howto/index
  39. sp_test/internal
  40. * :ref:`genindex`
  41. * :ref:`modindex`
  42. * :ref:`search`