User Tools

Site Tools


extensions:teemip-macaddress-lookup

This is an old revision of the document!


MAC Address Lookup

name:
MAC address lookup
description:
Provides information on MAC address vendors
version:
1.0.0
release:
2020-10-04
TeemIp:
2.6
code:
teemip-macaddress-lookup
state:
stable
keyword:
IP address, CMDB
dependencies:
teemip-ip-mgmt
git hub:
teemip-macaddress-lookup

TeemIp's MAC Address Lookup extension allows you to lookup information on a specific MAC address or on the MAC addresses configured on CIs.

This module is embedded by default in TeemIp standalone. It can be deployed as an extension with TeemIp as a module.

Revision History

Version Release Date Comments
1.0.0 2020-10-04 Initial revision

Features

This extension allows CMDB managers to get live MAC address information either from a generic form where a MAC address or a prefix can be requested or directly from the details page of CIs that do have one or more MAC address attributes.

The MAC information is retrieved from the MACLookup site that is updated with the latest information from the IEEE directory. It contains:

  • Block start, end, size and type
  • Company name, address and country
  • Last update

Limitations

The extension relies on the public web site https://api.maclookup.app/. Therefore, it requires an access to the public Internet from the server hosting TeemIp.

Requirements

Beside the capability for TeemIp to reach the public Internet (see above), there is no specific requirement with that extension. TeemIp MAC Address Lookup is embedded in TeemIp standalone starting with TeemIp 2.7.

When installed on an iTop application, make sure that 'IPAM for iTop' is installed as well.

Installation

Installation on a TeemIp standalone is done with the application itself, through the setup.

When adding the module on an iTop application, follow the Standard installation process.

Licensing

Configuration

No specific configuration is required in TeemIp's configuration file or in IP configs for that extension.

MAC Lookup menu

Once installed, the extension will alter the IP Management menu by adding the sub menu “MAC Lookup” under the Tools section.

Clicking on this menu will open the following form where either a MAC address or a MAC address prefix can be entered.

When the form is applied, a lookup request is sent to the MACLookup site through its standard API. Answer is then processed and displayed within TeemIp's main interface.

Parameter Description Comment
Block start Start MAC range
Block end End MAC range
Block size Number of possible unique MAC for this prefix
Block type Assignment Type
* MA-L: MAC Address Block Large (previously named OUI). Number of address 2^24 (~16 Million)
* MA-M: MAC Address Block Medium. Number of address 2^20 (~1 Million)
* MA-S: MAC Address Block Small (previously named OUI-36, encompasses IAB Assignments). Number of address 2^12 (4096)
* CID: Company Identifier. This prefix will not be used for globally unique applications. Number of address 2^24 (~16 Million) 
Company Company name
Address Company address
Country Company country
Random This MAC can be transmitted when a device is not associated with an access point. In this case, it can be considered randomized Optional
Private The company prevents their name and address from showing up in the public listing

* MA-M: MAC Address Block Medium. Number of address 2^20 (~1 Million)
* MA-S: MAC Address Block Small (previously named OUI-36, encompasses IAB Assignments). Number of address 2^12 (4096)
* CID: Company Identifier. This prefix will not be used for globally unique applications. Number of address 2^24 (~16 Million) | |

FIXME – Documentation to be completed.

extensions/teemip-macaddress-lookup.1604154681.txt.gz · Last modified: 2020/10/31 15:31 by cnaud