'\" t
.\"     Title: authselect-migration
.\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 2021-06-05
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "AUTHSELECT\-MIGRATIO" "7" "2021\-06\-05" "\ \&" "\ \&"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
authselect-migration \- authconfig から authselect への移行方法を示したガイド。
.SH "説明"
.sp
この man ページでは、authconfig と authselect の主な違いについて説明します。authconfig は、システム認証およびアイデンティティーソースを設定するツールの旧バージョンで、authselect は新バージョンになります。authconfig から authselect への移行に必要なアクションについても説明します。
.SH "主な差異"
.sp
authselect ツールは、システム設定に対して旧バージョンの authconfig とはまったく異なるアプローチをとります。
.sp
authconfig は、生成したファイルに対してユーザーが実施する手動での変更を維持するよう最善を尽くします。(認証モジュールとアイデンティティーソースのセットアップ用に) PAM 設定ファイルおよび nsswitch\&.conf を生成するだけでなく、LDAP および Kerberos などのいくつかのサービス用に簡単な設定ファイルも生成します。
.sp
authselect は、そのようなことはしません。PAM および nsswitch\&.conf 以外の設定ファイルは生成しません。また、生成された設定に対する手動での変更を固く禁止しています。プロファイルと呼ばれるファイルのセットを提供します。各プロファイルは、結果として得られる設定について説明し、特定のオプション機能を有効化または無効化することで若干変更することができます。authselect が出荷するプロファイルとは別のプロファイルへのニーズが生じた場合、管理者は、オプションでまったく新しいプロファイルを作成して authselect と共に使用することができます。プロファイルの詳細は、authselect\-profiles(5) を参照してください。
.sp
これは大きな欠点と思えるかもしれませんが、実際はその反対です。authconfig は非常に古いツールで、必要なサービスを提供するアプリケーションは、ここ数年で急激に変化しました。一般に、PAM および nsswitch\&.conf では、複数の認証モジュールはもう必要ありません。なぜなら、ユースケースの大部分は SSSD でカバーされるからです。 したがって、それらを特に追加したり削除したりする必要がありません。「レルム」などのリモートドメインに参加するプロセスの自動化を支援できるシステムデーモンの設定を生成するより優れたツールもあります。さらに、出荷されたプロファイルのシステム設定は、完全にテストが可能で、大幅にエラーが起こりにくい包括的かつ決定論的なものとなっています。また、このような設定を多くのシステムに渡って配布することは、格段に簡単になります。
.sp
おそらく、最も問題視されている変更は、authselect がプロファイルを sssd プロバイダーと winbind プロバイダーのみに出荷する点です。これらの 2 つのプロバイダーは、ローカルユーザーとレガシー LDAP ドメインの提供から、IPA サーバーまたは Active Directory サーバーを使用した複雑な設定まで、現在のすべてのユースケースをカバーします。プロファイルは今後、nss\-pam\-ldapd をサポートしません。ユーザーには、sssd への乗り換えを推奨しています。
.SH "リモートドメインへの参加"
.sp
IPA ドメインへの参加には、「ipa\-client\-install」または「レルム」のいずれかを使用でき、Active Directory ドメインへの参加には「レルム」を使用できます。これらのツールは、正しい authselect プロファイルが選択され、すべてのデーモンおよびサービスが正しく設定されていることを確認します。
.SH "スクリプトの変換"
.sp
ドメインへの参加に「ipa\-client\-install」または「レルム」を使用する場合は、単にスクリプト内の authconfig コールを削除します。このオプションを利用できない場合は、必要な機能を持つ正しいプロファイルを選択するために、各 authconfig コールをこれと同等の authselect コールと置き換える必要があります。続いて、必要なサービスに設定ファイルを書き込む必要もあります。
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.B Table\ \&1.\ \&authselect プロファイルに対する authconfig オプションの関係
.TS
allbox tab(:);
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt.
T{
.sp
\fBAuthconfig options\fR
T}:T{
.sp
\fBAuthselect profile\fR
T}
T{
.sp
\-\-enableldap \-\-enableldapauth
T}:T{
.sp
sssd
T}
T{
.sp
\-\-enablesssd \-\-enablesssdauth
T}:T{
.sp
sssd
T}
T{
.sp
\-\-enablekrb5
T}:T{
.sp
sssd
T}
T{
.sp
\-\-enablewinbind \-\-enablewinbindauth
T}:T{
.sp
winbind
T}
T{
.sp
\-\-enablenis
T}:T{
.sp
none
T}
.TE
.sp 1
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.B Table\ \&2.\ \&authselect プロファイル機能に対する authconfig オプションの関係
.TS
allbox tab(:);
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt
lt lt.
T{
.sp
\fBAuthconfig options\fR
T}:T{
.sp
\fBAuthselect profile feature\fR
T}
T{
.sp
\-\-enablesmartcard
T}:T{
.sp
with\-smartcard
T}
T{
.sp
\-\-enablefingerprint
T}:T{
.sp
with\-fingerprint
T}
T{
.sp
\-\-enablemkhomedir
T}:T{
.sp
with\-mkhomedir
T}
T{
.sp
\-\-enablefaillock
T}:T{
.sp
with\-faillock
T}
T{
.sp
\-\-enablepamaccess
T}:T{
.sp
with\-pamaccess
T}
T{
.sp
\-\-enablewinbindkrb5
T}:T{
.sp
with\-krb5
T}
T{
.sp
\-\-enableshadow
T}:T{
.sp
\fInone\fR
T}
T{
.sp
\-\-passalgo
T}:T{
.sp
\fInone\fR
T}
.TE
.sp 1
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBNote\fR
.ps -1
.br
.sp
Authconfig オプション \-\-enableshadow`と \-\-passalgo = sha512`は、パスワードが sha512`アルゴリズムを使用して / etc / shadow`に確実に保存されるようにするためによく使用されていました。 * authselect プロファイルはsha512ハッシュメソッドを使用するようになりました*。オプションを使用して変更することはできません(カスタムプロファイルを作成する場合のみ）。 これらのオプションは省略できます。
.sp .5v
.RE
.PP
\fB例\fR. 
.sp
.if n \{\
.RS 4
.\}
.nf
authconfig \-\-enableldap \-\-enableldapauth \-\-enablefaillock \-\-updateall
authselect select sssd with\-faillock

authconfig \-\-enablesssd \-\-enablesssdauth \-\-enablesmartcard \-\-smartcardmodule=sssd \-\-updateall
authselect select sssd with\-smartcard

authconfig \-\-enablepamaccess \-\-updateall
authselect select sssd with\-pamaccess

authconfig \-\-enablewinbind \-\-enablewinbindauth \-\-winbindjoin=Administrator \-\-updateall
realm join \-U Administrator \-\-client\-software=winbind WINBINDDOMAIN
.fi
.if n \{\
.RE
.\}
.sp
.SH "設定ファイル"
.sp
本セクションには、様々なサービスの最小限の設定に関するスニペットが含まれています。
.SS "LDAP"
.sp
LDAP が「pam_ldap」および「nss_ldap」を介して直接的に使用されていない場合でも、openldap\-libs の設定、そして間接的に ldapsearch などの LDAP ツールを設定するために ldap\&.conf を設定することは有用です。
.PP
\fB/etc/openldap/ldap.conf\fR. 
.sp
.if n \{\
.RS 4
.\}
.nf
# 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
.fi
.if n \{\
.RE
.\}
.sp
.SS "Kerberos"
.sp
Kerberos を使用する場合、デフォルトの Kerberos レルムは krb5\-libs のために設定されなければなりません。それによって、「kinit」などのツールが追加設定なしで機能するようになります。
.PP
\fB/etc/krb5.conf\fR. 
.sp
.if n \{\
.RS 4
.\}
.nf
[libdefaults]
 default_realm = MYREALM

[realms]
 MYREALM = {
  kdc = kdc\&.myrealm\&.org
 }

[domain_realm]
 myrealm\&.org = MYREALM
 \&.myrealm\&.org = MYREALM
.fi
.if n \{\
.RE
.\}
.sp
.SS "SSSD"
.sp
authselect は、可能な限り SSSD を使用するようユーザーに推奨しています。多くの設定オプションがあります。詳細は sssd\&.conf(5) を参照してください。これは「デフォルト」と呼ばれる 1 つの LDAP ドメインを作成する最小限の設定です。LDAP サーバーは、DNS ルックアップを使用して自動検出されます。
.PP
\fB/etc/sssd/sssd.conf\fR. 
.sp
.if n \{\
.RS 4
.\}
.nf
[sssd]
config_file_version = 2
domains = default

[domain/default]
id_provider = ldap
ldap_uri = _srv_
dns_discovery_domain = myrealm
.fi
.if n \{\
.RE
.\}
.sp
これは、同じドメインの設定スニペットですが、認証には Kerberos を使用します。KDC サーバーは、DNS ルックアップを使用して自動検出されます。
.PP
\fB/etc/sssd/sssd.conf\fR. 
.sp
.if n \{\
.RS 4
.\}
.nf
[sssd]
config_file_version = 2
domains = default

[domain/default]
id_provider = ldap
auth_provider = krb5
ldap_uri = _srv_
krb5_server = _srv_
krb5_realm = MYREALM
dns_discovery_domain = myrealm
.fi
.if n \{\
.RE
.\}
.sp

.sp
.if n \{\
.RS 4
.\}
.nf
IPA または Active Directory ドメイン用に SSSD を設定したい場合は、「レルム」ツールを使用します。これにより、Kerberos keytab の作成および SSSD の基本設定の生成などの初期設定が実行されます。調整するには、{sysconfdir}/sssd/sssd\&.conf を変更します。
.fi
.if n \{\
.RE
.\}
.SS "Winbind"
.sp
マシンを設定して Winbind を使用するには「レルム」を使います。これにより、Kerberos keytab の作成およびドメインに参加するために「adcli」を実行するなどの初期設定が実行されます。「smb\&.conf」にも変更を加えます。調整するには、/etc/samba/smb\&.conf を変更します。
.SS "NIS"
.sp
NIS 認証を機能させる上で設定が必要な箇所がいくつかあります。まず、NIS ドメインを設定する必要があり、オプションで /etc/yp\&.conf に NIS サーバーも設定します。
.PP
\fB/etc/yp.conf\fR. 
.sp
.if n \{\
.RS 4
.\}
.nf
domain mydomain broadcast
# or
# domain mydomain server myserver
.fi
.if n \{\
.RE
.\}
.sp
NIS ドメインは、システムネットワーク設定でも設定される必要があります。
.PP
\fB/etc/sysconfig/network\fR. 
.sp
.if n \{\
.RS 4
.\}
.nf
NISDOMAIN=mydomain
.fi
.if n \{\
.RE
.\}
.sp
続いて、システムを再起動する必要がないように、コマンドラインでドメイン名を設定することができます。さらに、selinux の NIS を有効にする必要があるかもしれません。
.sp
.if n \{\
.RS 4
.\}
.nf
$ domainname mydomain
$ setsebool \-P allow_ypbind 1
.fi
.if n \{\
.RE
.\}
.SS "パスワードの品質"
.sp
authselect は「pam_pwquality」モジュールを有効にし、パスワード品質制限を実施します。このモジュールは、ローカルユーザーに対してのみ有効となります。リモートユーザーは、各リモートサーバーが実行するパスワードポリシーを使用する必要があります。
.sp
「pam_pwquality」モジュールは、/etc/security/pwquality\&.conf に設定できます。設定オプションとデフォルトの詳細は pam_pwquality(8) を参照してください。
.SH "サービスの起動"
.sp
設定によっては、 systemd を使用して必要なサービスを手動で開始する必要があります。
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
SSSD
.sp
.if n \{\
.RS 4
.\}
.nf
systemctl は sssd\&.service を有効にします ; systemctl は sssd\&.service を開始します
.fi
.if n \{\
.RE
.\}
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Winbind
.sp
.if n \{\
.RS 4
.\}
.nf
systemctl は winbind\&.service を有効にします ; systemctl は winbind\&.service を開始します
.fi
.if n \{\
.RE
.\}
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
NIS
.sp
.if n \{\
.RS 4
.\}
.nf
systemctl は rpcbind\&.service を有効にします ; systemctl は rpcbind\&.service を開始します
systemctl は ypbind\&.service を有効にします ; systemctl は ypbind\&.service を開始します
.fi
.if n \{\
.RE
.\}
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
mkhomedir 機能が有効な場合
.sp
.if n \{\
.RS 4
.\}
.nf
systemctl は oddjobd\&.service を有効にします ; systemctl は oddjobd\&.service を開始します
.fi
.if n \{\
.RE
.\}
.RE
.SH "AUTHCONFIG ツール"
.sp
authconfig は、\fIcacertdir_rehash\fR と呼ばれるツールを出荷しました。このツールに依存する場合は、同じ目的を持つ native \fIopenssl\fR command: \fBopenssl rehash <directory>\fR に切り替えてください。
.SH "以下も参照してください"
.sp
authselect(8)、authselect\-profiles(5)、realm(8)、ipa\-client\-install(1)、sssd\&.conf(5)、smb\&.conf(5)、ldap\&.conf(5)、krb5\&.conf(5)
