Description\n-----------\n\nThe named_pipe authentication plugin allows the user to use operating system credentials when connecting to MariaDB via named pipe on Windows. Named pipe connections are enabled by the named_pipe system variable.\n\nThe named_pipe authentication plugin works by using named pipe impersonation.aspx) and calling GetUserName() to retrieve the user name of the process that is connected to the named pipe. Once it has the user name, it authenticates the connecting user as the MariaDB account that has the same user name.\n\nInstalling the Plugin\n\nAlthough the plugin's shared library is distributed with MariaDB by default, the plugin is not actually installed by MariaDB by default. There are two methods that can be used to install the plugin with MariaDB.\n\nThe first method can be used to install the plugin without restarting the server. You can install the plugin dynamically by executing INSTALL SONAME or INSTALL PLUGIN:\n\n``sql\nINSTALL SONAME 'auth_named_pipe';\n`\n\nThe second method can be used to tell the server to load the plugin when it starts up. The plugin can be installed this way by providing the --plugin-load or the --plugin-load-add options. This can be specified as a command-line argument to mariadbd, or it can be specified in a relevant server option group in an option file:\n\n`ini\n[mariadb]\n...\nplugin_load_add = auth_named_pipe\n`\n\nUninstalling the Plugin\n\nYou can uninstall the plugin dynamically by executing UNINSTALL SONAME or UNINSTALL PLUGIN:\n\n`sql\nUNINSTALL SONAME 'auth_named_pipe';\n`\n\nIf you installed the plugin by providing the --plugin-load or the --plugin-load-add options in a relevant server option group in an option file, those options should be removed to prevent the plugin from being loaded the next time the server is restarted.\n\nCreating Users\n\nTo create a user account via CREATE USER, specify the name of the plugin in the IDENTIFIED VIA clause:\n\n`sql\nCREATE USER username@hostname IDENTIFIED VIA named_pipe;\n`\n\nIf SQL_MODE does not have NO_AUTO_CREATE_USER set, then you can also create the user account via GRANT:\n\n`sql\nGRANT SELECT ON db.* TO username@hostname IDENTIFIED VIA named_pipe;\n`\n\nClient Authentication Plugins\n\nThe named_pipe authentication plugin does not require any specific client authentication plugins. It should work with all clients.\n\nSupport in Client Libraries\n\nThe named_pipe` authentication plugin does not require any special support in client libraries. It should work with all client libraries.\n\nExamples\n--------\n\nCREATE USER wlad IDENTIFIED VIA named_pipe;\nCREATE USER monty IDENTIFIED VIA named_pipe;\nquit\n\nC:\\>echo %USERNAME%\nwlad\n\nC:\\> mysql --user=wlad --protocol=PIPE\nWelcome to the MariaDB monitor.  Commands end with ; or \\g.\nYour MariaDB connection id is 4\nServer version: 10.1.12-MariaDB-debug Source distribution\n\nCopyright (c) 2000, 2015, Oracle, MariaDB Corporation Ab and others.\n\nType 'help;' or '\\h' for help. Type '\\c' to clear the current input statement.\n\nMariaDB [(none)]> quit\nBye\n\nC:\\> mysql --user=monty  --protocol=PIPE\nERROR 1698 (28000): Access denied for user 'monty'@'localhost'\n\nURL: https://mariadb.com/docs/server/reference/plugins/authentication-plugins/authentication-plugin-named-pipe