This documentation is for WSO2 API Manager 1.5.0 View documentation for the latest release.
Page Comparison - Configuring api-manager.xml (v.11 vs v.12) - API Manager 1.5.0 - WSO2 Documentation

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Note

Some sections here are still under construction.

Users can change the default API Manager -specific functionality related configurations by editing <PRODUCT_HOME>/repository/conf/api-manager.xml file using the information given below.

File Details

  • File Name: api-manager.xml
  • Location: <PRODUCT_HOME>/repository/conf
  • Purpose: Store all API Manager functionality related configurations.

...

XML elements
Anchor
elements
elements

 Click on a main an element to view its details along with specifics on its sub elements.

  • <APIManager>
  •        <DataSourceName>
  •        <Database>
  •                <URL>
  •                <Username>
  •                <Password>
  •                <Driver>
  •        <AuthManager>

  •                <ServerURL>

  •                <Username>

  •                <Password>

  •        <APIConsumerAuthentication>

  •                <SecurityContextHeader>

  •                <ClaimsRetrieverImplClass>

  •                <ConsumerDialectURI>

  •                <SignatureAlgorithm>

  •                <EnableTokenGeneration>
  •        <APIGateway>
    • <Environments>
      • <Environment type="hybrid">
        • <ServerURL>
        • <Username>

        • <Password>

        • <GatewayEndpoint>
    • <EnableGatewayKeyCache>
    • <ClientDomainHeader>
  •        <APIUsageTracking>

  •                <Enabled>

  •                <PublisherClass>

  •                <ThriftPort>

  •                <BAMServerURL>

  •                <BAMUsername>

  •                <BAMPassword>

  •                <DataSourceName>

  •       <APIKeyManager>

  •                <ServerURL>

  •                <Username>

  •                <Password>

  •                <EnableJWTCache>

  •               <EnableKeyMgtValidationInfoCache>

  •               <KeyValidatorClientType>

  •               <ThriftClientPort>

  •               <ThriftClientConnectionTimeOut>

  •               <ThriftServerPort>

  •               <RemoveUserNameToJWTForApplicationToken>

  •       <TierManagement>

  •               <EnableUnlimitedTier>

  •       <SelfSignUp>

  •               <Enabled>

  •               <SubscriberRoleName>

  •               <CreateSubscriberRole>

  •       <APIStore>

  •               <DisplayMultipleVersions>

  •               <DisplayAllAPIs>

  •               <DisplayComments>

  •               <DisplayRatings>

  •       <StatusObservers>

  •               <Observer>

...

 <DataSourceName> 
Anchor

...

DataSourceName

...

DataSourceName

XML Syntax <DataSourceName/>
Description 

JNDI name of the datasource to be used by the API publisher, API store and API key manager. This datasource should be defined in the master-datasources.xml file in conf/datasources directory.

Type String
Default Value N/A
Fixed Values N/A
Mandatory/Optional 


Sample Implementations

...

Back to Top ^

...

 

...

Code Block

...

 

Sample Implementations
language

...

html/xml
<DataSourceName>jdbc/WSO2AM_DB</DataSourceName>

 

Back to Top ^

...

<Database>
Anchor
Database
Database

...

Sub ElementXML SyntaxDescriptionTypeDefault ValueFixed ValuesMandatory/Optional
<URL>      
<Username>      

<Password>

      

<Driver>

      
 
Sample Implementations

Back to Top ^

...

 <AuthManager> 
Anchor
AuthManager
AuthManager

...

Sub ElementXML SyntaxDescriptionTypeDefault ValueFixed ValuesMandatory/Optional
<ServerURL>      
<Username>      

<Password>

      
 
Sample Implementations

Back to Top ^

...

<APIConsumerAuthentication> 
Anchor
APIConsumerAuthentication
APIConsumerAuthentication

...

Sub ElementXML SyntaxDescriptionTypeDefault ValueFixed ValuesMandatory/Optional
<SecurityContextHeader>      
<ClaimsRetrieverImplClass>      

<ConsumerDialectURI>

      
<SignatureAlgorithm>      
<EnableTokenGeneration>      
Sample Implementations

Back to Top ^

...

<APIGateway>
Anchor
APIGateway
APIGateway

...

Sub ElementXML SyntaxDescriptionTypeDefault ValueFixed ValuesMandatory/Optional
<Environments><Environments>Lists all configured API Gateway environments   Mandatory
<Environment><Environment type="hybrid | production | sandbox">Defines the environment details of a Gateway   At least 1 environment mandatory
<Name><Name>The name of the given Gateway Environment Production and Sandbox Mandatory
<ServerURL><ServerURL>Specifies the server management url of the API Gateway   Mandatory
<Username><Username>Specifies the administrative username of the API Gateway admin Mandatory

<Password>

<Password>Specifies the administrative password of the API Gateway admin Mandatory
<GatewayEndpoint><GatewayEndpoint>Specifies the gateway url to be exposed for calling clients   Mandatory
<EnableGatewayKeyCache><EnableGatewayKeyCache>Enables/Disables key (token) caching at the Gateway false  
<ClientDomainHeader><ClientDomainHeader>

Header name is configurable. When an API invocation is restricted to authorized domains, the request must send the domain name as the value of this element. So that the API Gateway can identify it as an authorized request and allow access to the APIs. Also see Application Access Tokens.

 referer  
 
Sample Implementations

 

<APIGateway>
   <Environments>
      <Environment type="hybrid">
         <Name>Production and Sandbox</Name>
         <ServerURL>https://10.100.1.100:9443/services/</ServerURL>
         <Username>admin</Username>
         <Password>admin</Password>
         <GatewayEndpoint>http://10.100.1.100:8280,https://10.100.1.100:8243</GatewayEndpoint>
      </Environment>
      <Environment type="production">
         <Name>Production</Name>
         <ServerURL>https://10.100.1.101:9443/services/</ServerURL>
         <Username>admin</Username>
         <Password>admin</Password>
         <GatewayEndpoint>http://10.100.1.101:8280,https://10.100.1.101:8243</GatewayEndpoint>
      </Environment>
      <Environment type="sandbox">
         <Name>Sandbox</Name>
         <ServerURL>https://10.100.1.102:9443/services/</ServerURL>
         <Username>admin</Username>
         <Password>admin</Password>
         <GatewayEndpoint>http://10.100.1.102:8280,https://10.100.1.102:8243</GatewayEndpoint>
      </Environment>
      </Environments>
     <EnableGatewayKeyCache>false</EnableGatewayKeyCache>
     <ClientDomainHeader>referer</ClientDomainHeader>
</APIGateway>

...

Sub ElementXML SyntaxDescriptionTypeDefault ValueFixed ValuesMandatory/Optional
<Enabled>      
<PublisherClass>      

<ThriftPort>

      
<BAMServerURL>      
<BAMUsername>      
<BAMPassword>      

<DataSourceName>

      
 
Sample Implementations

Back to Top ^

...

<APIKeyManager> 
Anchor
APIKeyManager
APIKeyManager

...

Sub ElementXML SyntaxDescriptionTypeDefault ValueFixed ValuesMandatory/Optional
<ServerURL>      
<Username>      

<Password>

      
<EnableJWTCache>      
<EnableKeyMgtValidationInfoCache>      
<KeyValidatorClientType>      

<ThriftClientPort>

      
<ThriftClientConnectionTimeOut>      
<ThriftServerPort>      
<RemoveUserNameToJWTForApplicationToken>      
 
Sample Implementations

Back to Top ^

...

<TierManagement> 
Anchor
TierManagement
TierManagement

...

Sub ElementXML SyntaxDescriptionTypeDefault ValueFixed ValuesMandatory/Optional
<EnableUnlimitedTier>      
 
Sample Implementations

Back to Top ^

...

<SelfSignUp> 
Anchor
SelfSignUp
SelfSignUp

...

Sub ElementXML SyntaxDescriptionTypeDefault ValueFixed ValuesMandatory/Optional
<Enabled>      
<SubscriberRoleName>      

<CreateSubscriberRole>

      
 
Sample Implementations

Back to Top ^

...

<APIStore> 
Anchor
APIStore
APIStore

...

Sub ElementXML SyntaxDescriptionTypeDefault ValueFixed ValuesMandatory/Optional
<DisplayMultipleVersions>      
<DisplayAllAPIs>      

<DisplayComments>

      
<DisplayRatings>      
 
Sample Implementations

Back to Top ^

...

<StatusObservers> 
Anchor
StatusObservers
StatusObservers

...

Sub ElementXML SyntaxDescriptionTypeDefault ValueFixed ValuesMandatory/Optional
<Observer>      
 
Sample Implementations

<ExtensionHandlerPosition>

...