authselect/1.2.x-authselect-migration.7.adoc — English @ Fedora Weblate: |*Authconfig options* |*Authselect profile* |--enableldap --enableldapauth |sssd |--enablesssd --enablesssdauth |sssd …

Source string Source string

English

|*Authconfig options*                |*Authselect profile*
|--enableldap --enableldapauth       |sssd
|--enablesssd --enablesssdauth       |sssd
|--enablekrb5                        |sssd
|--enablewinbind --enablewinbindauth |winbind
|--enablenis                         |nis

Needs editing

The string is read only.

Skip

	English	Actions
	NAME
	authselect-migration - A guide how to migrate from authconfig to authselect.
	DESCRIPTION
	This manual page explains the main differences between authconfig, the previous tool to configure system authentication and identity sources, and authselect which replaces it. It also explains what actions need to be done in order to migrate from authconfig to authselect.
	MAIN DIFFERENCES
	Authselect takes a completely different approach to system configuration than the previous tool authconfig.
	Authconfig tries its best to keep users's manual changes to the files it generates. It generates not only PAM configuration files and nsswitch.conf (to setup authentication modules and identity sources) but it also generates simple configuration files for several services such as LDAP and Kerberos.
	Authselect does no such things. It does not generate any configuration files beside PAM and nsswitch.conf and it strictly prohibits any manual changes to generated configuration. It provides a set of files called profiles. Each profile describes how the resulting configuration should look like and it can be slightly modified by enabling or disabling certain optional features. If a need arises for a different profile than what authselect ships, the administrator has an option to create a whole new profile and use it with authselect. See authselect-profiles(5) to learn more about profiles.
	This may seem like a big disadvantage but the truth is the opposite. Authconfig is a very old tool and the applications providing required services have changed rapidly over the years. Typically, there is no longer a need to have multiple authentication modules in PAM and nsswitch.conf, because the vast majority of use-cases is covered by SSSD. Therefore there is no need to add or remove them specifically. There are also better tools to generate configuration for system daemons that can help you automate the process of joining to a remote domain such as `realm`. In addition, the shipped profiles give us comprehensive and deterministic system configuration that can be fully tested and is much less error prone. It is also much easier to distribute such configuration across many systems.
	Probably the most controversial change is that authselect only ships profiles for sssd and winbind providers. Those two providers cover all modern use cases from providing local users and legacy LDAP domain to complex configurations with IPA or Active Directory servers. The profiles no longer contain support for nss-pam-ldapd and users are encouraged to switch to sssd.
	JOINING REMOTE DOMAINS
	You can use either `ipa-client-install` or `realm` to join an IPA domain and `realm` to join an Active Directory domain. These tools will make sure that the correct authselect profile is selected and all daemons and services are properly configured.
	CONVERTING YOUR SCRIPTS
	If you use `ipa-client-install` or `realm` to join a domain, you can just remove any authconfig call in your scripts. If this is not an option, you need to replace each authconfig call with its equivalent authselect call to select a correct profile with desired features. Then you also need to write configuration file for required services.
	Relation of authconfig options to authselect profiles
	\|Authconfig options \|Authselect profile \|--enableldap --enableldapauth \|sssd \|--enablesssd --enablesssdauth \|sssd \|--enablekrb5 \|sssd \|--enablewinbind --enablewinbindauth \|winbind \|--enablenis \|nis
	Relation of authconfig options to authselect profile features
	\|Authconfig options \|Authselect profile feature \|--enablesmartcard \|with-smartcard \|--enablefingerprint \|with-fingerprint \|--enableecryptfs \|with-ecryptfs \|--enablemkhomedir \|with-mkhomedir \|--enablefaillock \|with-faillock \|--enablepamaccess \|with-pamaccess \|--enablewinbindkrb5 \|with-krb5 \|--enableshadow \|_none_ \|--passalgo \|_none_
	Authconfig options `--enableshadow` and `--passalgo=sha512` were often used to make sure that passwords are stored in `/etc/shadow` using `sha512` algorithm. The authselect profiles now use the yescrypt hashing method and it cannot be changed through an option (only by creating a custom profile). You can just omit these options.
	Examples
	authconfig --enableldap --enableldapauth --enablefaillock --updateall authselect select sssd with-faillock
	authconfig --enablesssd --enablesssdauth --enablesmartcard --smartcardmodule=sssd --updateall authselect select sssd with-smartcard
	authconfig --enableecryptfs --enablepamaccess --updateall authselect select sssd with-ecryptfs with-pamaccess
	authconfig --enablewinbind --enablewinbindauth --winbindjoin=Administrator --updateall realm join -U Administrator --client-software=winbind WINBINDDOMAIN
	CONFIGURATION FILES
	This section contains snippets for minimal configuration of various services.
	LDAP
	Even if LDAP is not directly used through `pam_ldap` and `nss_ldap`, it is still useful to configure ldap.conf to configure openldap-libs and indirectly, e.g. LDAP tools such as `ldapsearch`.
	{sysconfdir}/openldap/ldap.conf
	# Set the default base dn BASE dc=example,dc=com
	# Set the default LDAP server URI ldap://ldap.example.com ldap://ldap-master.example.com:666

Loading…

None

String updated in the repository

English

English 276 characters edited Current translation Read only

2 years ago

Browse all string changes

Things to check

Multiple failing checks

Following checks are failing:
Unchanged translation: Czech, German, Japanese

Reset

Glossary

English	English
No related strings found in the glossary.

String information

Source string description

type: Table

Flags

c-format, no-wrap, read-only

Source string location

./src/man/authselect-migration.7.adoc:76

String age

2 years ago

Last updated

a year ago

Source string age

2 years ago

Translation file

src/man/po/authselect-migration.7.adoc.pot, string 17

Shortcut	Action
`?`	Open available keyboard shortcuts.
`Alt` + `Home`	Navigate to the first translation in the current search.
`Alt` + `End`	Navigate to the last translation in the current search.
`Alt` + `PageUp` or `Ctrl` + `↑` or `Alt` + `↑` or `Cmd` + `↑` or	Navigate to the last translation in the current search.
`Alt` + `PageDown` or `Ctrl` + `↓` or `Alt` + `↓` or `Cmd` + `↓` or	Navigate to the next translation in the current search.
`Ctrl` + `Enter` or `Cmd` + `Enter`	Submit current form; this works the same as pressing Save and continue while editing translation.
`Ctrl` + `Shift` + `Enter` or `Cmd` + `Shift` +`Enter`	Unmark translation as Needing edit and submit it.
`Alt` + `Enter` or `Option` + `Enter`	Submit the string as a suggestion; this works the same as pressing Suggest while editing translation.
`Ctrl` + `E` or `Cmd` + `E`	Focus on translation editor.
`Ctrl` + `U` or `Cmd` + `U`	Focus on comment editor.
`Ctrl` + `M` or `Cmd` + `M`	Shows Automatic suggestions tab.
`Ctrl` + `1` to `Ctrl` + `9` or `Cmd` + `1` to `Cmd` + `9`	Copies placeable of a given number from source string.
`Ctrl` + `M` followed by `1` to `9` or `Cmd` + `M` followed by `1` to `9`	Copy the machine translation of a given number to current translation.
`Ctrl` + `I` followed by `1` to `9` or `Cmd` + `I` followed by `1` to `9`	Ignore one item in the list of failing checks.
`Ctrl` + `J` or `Cmd` + `J`	Shows the Nearby strings tab.
`Ctrl` + `S` or `Cmd` + `S`	Focus on search field.
`Ctrl` + `O` or `Cmd` + `O`	Copy the source string.
`Ctrl` + `Y` or `Cmd` + `Y`	Toggle the Needs editing checkbox.
`→`	Browse the next translation string.
`←`	Browse the previous translation string.