diff options
author | Michael Albinus <michael.albinus@gmx.de> | 2019-01-26 16:46:54 +0100 |
---|---|---|
committer | Michael Albinus <michael.albinus@gmx.de> | 2019-01-26 16:46:54 +0100 |
commit | ceccb3c8c4461cfb69b64d94a57709393b8c39fd (patch) | |
tree | c3ed72ebc68d6f42f6bdaf71ebcd2b6d23af5392 | |
parent | 9078f34e84178553cd59bc03ac1b58cb56038436 (diff) | |
download | emacs-ceccb3c8c4461cfb69b64d94a57709393b8c39fd.tar.gz |
New node Authentication in the Emacs manual
* doc/emacs/custom.texi (Customization):
* doc/emacs/emacs.texi (Top): Add node Authentication.
-rw-r--r-- | doc/emacs/custom.texi | 38 | ||||
-rw-r--r-- | doc/emacs/emacs.texi | 1 |
2 files changed, 39 insertions, 0 deletions
diff --git a/doc/emacs/custom.texi b/doc/emacs/custom.texi index 4aaf58cc264..32706f3868d 100644 --- a/doc/emacs/custom.texi +++ b/doc/emacs/custom.texi @@ -32,6 +32,8 @@ Reference Manual}. By changing them, you can redefine keys. * Init File:: How to write common customizations in the initialization file. +* Authentication:: Keeping persistent authentication information. + @end menu @node Easy Customization @@ -2609,3 +2611,39 @@ instance: @noindent Type @kbd{C-q}, followed by the key you want to bind, to insert @var{char}. + +@node Authentication +@section Keeping Persistent Authentication Information +@cindex ~/.authinfo file +@cindex ~/.authinfo.gpg file +@cindex ~/.netrc file + + Some Emacs packages, which connect to other services, require +authentication (@pxref{Passwords}), e.g., @ref{Top, Gnus,, gnus, The +Gnus Manual}, or @ref{Top, Tramp,, tramp, The Tramp Manual}. Because +it might be annoying to provide the same user name and password again +and again, Emacs offers to keep this information persistent via the +auth-source library. + + Per default, this information is taken from the file +@file{~/.authinfo} or @file{~/.authinfo.gpg} or @file{~/.netrc}. +These files have a syntax similar to netrc files as known from the ftp +program, like + +@example +machine @var{mymachine} login @var{myloginname} password @var{mypassword} port @var{myport} +@end example + + Similarly, the auth-source library supports multiple storage +backend, currently either the classic netrc backend, JSON files, the +Secret Service API, and pass, the standard unix password manager. + +@vindex auth-sources + All these alternatives are customized via the user option +@code{auth-sources}, @ref{Top, Emacs auth-source,, auth, Emacs auth-source}. + +@vindex auth-source-save-behavior + When a password is entered interactively, which is not found via the +configured backend, some of the backends offer to save it +persistently. This can be changed by the customizing user option +@code{auth-source-save-behavior}. diff --git a/doc/emacs/emacs.texi b/doc/emacs/emacs.texi index d501db71914..5b16d5034f1 100644 --- a/doc/emacs/emacs.texi +++ b/doc/emacs/emacs.texi @@ -1114,6 +1114,7 @@ Customization By changing them, you can redefine keys. * Init File:: How to write common customizations in the initialization file. +* Authentication:: Keeping persistent authentication information. Easy Customization Interface |