fphammerle/yii2-client-cert-auth

yii2 extension for automatic login via TLS/SSL/HTTPS client certificates

1.0.0-alpha 2017-07-16 22:31 UTC

Requires

• php: >=5.4.0
• yiisoft/yii2: ^2.0

Requires (Dev)

• fphammerle/helpers: ^1.2
• phpunit/phpunit: ^4.8

MIT

• Fabian Peter Hammerle

• Authentication
• https
• x509
• ssl
• yii2
• client certificate

README

yii2 extension for automatic login via TLS/SSL/HTTPS client certificates

Setup

1. Configure Webserver

apache

<VirtualHost example.hammerle.me:443>
    # ...

    SSLEngine on
    SSLCertificateFile /etc/somewhere/example-server-cert.pem
    SSLCertificateKeyFile /etc/restricted/example-server-key.pem

    SSLVerifyClient optional
    SSLVerifyDepth 1
    SSLCACertificateFile /etc/somewhere/example-client-cert-ca.pem
    SSLOptions +StdEnvVars
</VirtualHost>

2. Install Extension

composer require fphammerle/yii2-client-cert-auth

3. Create Table

./yii migrate --migrationPath=./vendor/fphammerle/yii2-client-cert-auth/migrations

4. Enable Extension in Yii's Application Config

$config = [
    // ...
    'bootstrap' => ['clientCertAuth'],
    'components' => [
        // ...
        'clientCertAuth' => \fphammerle\yii2\auth\clientcert\Authenticator::className(),
    ],
    // ...
];

5. Register Client Certificates

$subj = new \fphammerle\yii2\auth\clientCert\Subject;
$subj->identity = \Yii::$app->user->identity;
$subj->distinguished_name = "CN=Fabian,C=AT";
$subj->save();