Server Connection

To connect to a data source with SAS Federation Server, you must first connect to SAS Federation Server. A server connection is established by specifying server connection LIBNAME options in the LIBNAME statement.

SAS Federation Server can be running on the local computer or on a remote computer. The SAS program connects as a client of SAS Federation Server. The data source connection options identify the computer on which the server is running, the port number that is used to access the server, and user authentication credentials.

Here is an example of the code that is necessary to connect to SAS Federation Server and access a SAS data set.

libname lib1 fedsvr server="d1234.us.company.com"
   port=2171 user="myid" password=mypwd
   dsn="BaseDSN";

proc print data=lib3.table1;
run;

In the example, FEDSVR is the name of the LIBNAME engine and SERVER=, PORT=, USER=, and PASSWORD= are server connection LIBNAME options.

DSN= is a data source connection option. For more information, see Data Source Connection.

Authentication to SAS Federation Server is controlled by SAS Metadata Server. The users and groups who can access SAS Federation Server are defined and maintained on SAS Metadata Server by the SAS Federation Server administrator. To obtain a valid login for SAS Federation Server, contact the SAS Federation Server administrator.

In a metadata-aware environment, the AUTHDOMAIN= LIBNAME option can be used to supply user credentials instead of the USER= and PASSWORD= LIBNAME options. A metadata-aware environment is a SAS session in which the METASERVER=, METAPORT=, METAUSER=, METAPASS=, and METAREPOSITORY= system options have been set and have successfully established a connection to a SAS Metadata Server. Metadata server connection system options can be specified in a configuration file or in the OPTIONS statement. The AUTHDOMAIN= LIBNAME option specifies the name of an authentication domain metadata object that is defined in the SAS Metadata Repository. Specifying an authentication domain is a convenient way to obtain metadata-based user credentials rather than having to explicitly supply them during server sign-on.

For more information about metadata authentication domains, see the SAS Intelligence Platform: Security Administration Guide. For an example of how AUTHDOMAIN= is used, see Authenticate with an Authentication Domain.