parameters: (realm, users, encrypt=None, debug=False)
docstring: If auth fails, raise 401 with a basic authentication header.
      
      realm
          A string containing the authentication realm.
          
      users
          A dict of the form: {username: password} or a callable returning a dict.
          
      encrypt
          callable used to encrypt the password returned from the user-agent.
          if None it defaults to a md5 encryption.
docstring_summary: If auth fails, raise 401 with a basic authentication header.
      
      realm
          A string containing the authentication realm.
          
      users
          A dict of the form: {username: password} or a callable returning a dict.
          
      encrypt
          callable used to encrypt the password returned from the user-agent.
          if None it defaults to a md5 encryption.
docstring_tokens: If auth fails raise 401 with a basic authentication header . realm A string containing the authentication realm . users A dict of the form : { username : password } or a callable returning a dict . encrypt callable used to encrypt the password returned from the user - agent . if None it defaults to a md5 encryption .
function: def basic_auth(realm, users, encrypt=None, debug=False):
      """If auth fails, raise 401 with a basic authentication header.
      
      realm
          A string containing the authentication realm.
          
      users
          A dict of the form: {username: password} or a callable returning a dict.
          
      encrypt
          callable used to encrypt the password returned from the user-agent.
          if None it defaults to a md5 encryption.
          
      """
      if check_auth(users, encrypt):
          if debug:
              cherrypy.log('Auth successful', 'TOOLS.BASIC_AUTH')
          return
      
      # inform the user-agent this path is protected
      cherrypy.serving.response.headers['www-authenticate'] = httpauth.basicAuth(realm)
      
      raise cherrypy.HTTPError(401, "You are not authorized to access that resource")
function_tokens: def basic_auth ( realm , users , encrypt = None , debug = False ) : if check_auth ( users , encrypt ) : if debug : cherrypy . log ( 'Auth successful' , 'TOOLS.BASIC_AUTH' ) return # inform the user-agent this path is protected cherrypy . serving . response . headers [ 'www-authenticate' ] = httpauth . basicAuth ( realm ) raise cherrypy . HTTPError ( 401 , "You are not authorized to access that resource" )