Oracle9i Application Server PL/SQL Web Toolkit Reference Release 1.0.2.2 Part Number A90101-01 |
|
This chapter describes the functions, procedures, and data types in the owa_sec
package in the PL/SQL Web Toolkit.
Parameters that have default values are optional.
owa_sec.get_client_hostname function - returns the client's hostname.
owa_sec.get_client_ip function - returns the client's IP address.
owa_sec.get_password function - returns the password that the user entered.
owa_sec.get_user_id function - returns the username that the user entered.
owa_sec.set_authorization procedure - enables the PL/SQL application to use custom authentication.
owa_sec.set_protection_realm procedure - defines the realm that the page is in.
This function returns the hostname of the client.
Properties | Definitions |
---|---|
Syntax: |
owa_sec.get_client_hostname return varchar2; |
Parameters: |
None. |
Returns: |
The hostname. |
This function returns the IP address of the client.
Properties | Definitions |
---|---|
Syntax: |
owa_sec.get_client_ip return owa_util.ip_address; |
Parameters: |
None. |
Returns: |
The IP address. The owa_util.ip_address data type is a PL/SQL table where the first four elements contain the four numbers of the IP address. For example, if the IP address is ipaddr(1) = 123 ipaddr(2) = 45 ipaddr(3) = 67 ipaddr(4) = 89 |
This function returns the password that the user used to log in. For security reasons, this function returns a true value only when custom authentication is used. If you call this function when you are not using custom authentication, the function returns an undefined value. Thus, the database passwords are not exposed.
Properties | Definitions |
---|---|
Syntax: |
owa_sec.get_password return varchar2; |
Parameters: |
None. |
Returns: |
The password. |
This function returns the username that the user used to log in.
Properties | Definitions |
---|---|
Syntax: |
owa_sec.get_user_id return varchar2; |
Parameters: |
None. |
Returns: |
The username. |
This procedure, called in the initialization portion of the owa_custom package, sets the authorization scheme for the PL/SQL Gateway. This implements your authorize
function, which authorizes the user before his requested procedure is run. The placement of the authorize
function depends on the scheme you selected.
This procedure sets the realm of the page that is returned to the user. The user enters a username and login that already exist in the realm.
Properties | Definitions |
---|---|
Syntax: |
owa_sec.set_protection_realm(realm in varchar2); |
Parameters: |
realm - the realm where the page belongs. This string is displayed to the user. |
Returns: |
Not applicable. |
|
Copyright © 2001 Oracle Corporation. All Rights Reserved. |
|