This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
extensions:teemip-macaddress-lookup [2020/10/31 15:31] – [MAC Lookup menu] cnaud | extensions:teemip-macaddress-lookup [2023/12/11 14:53] (current) – [MAC Address Lookup] cnaud | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== MAC Address Lookup ====== | + | {{ picto_macaddresslookup.png}} |
+ | ====== MAC Address Lookup ====== | ||
---- dataentry summary ---- | ---- dataentry summary ---- | ||
name : MAC address lookup | name : MAC address lookup | ||
- | description_wiki | + | description_wiki |
index_hidden | index_hidden | ||
level_hidden | level_hidden | ||
- | version | + | collector_hidden |
- | release_dt | + | version |
- | TeemIp | + | release_dt |
+ | TeemIp | ||
+ | iTop : 3.x | ||
code : teemip-macaddress-lookup | code : teemip-macaddress-lookup | ||
+ | localization | ||
state : stable | state : stable | ||
diffusion_hidden | diffusion_hidden | ||
- | product_hidden | + | product_hidden |
module-lists_hidden : | module-lists_hidden : | ||
- | keyword_tags | + | keyword_tags |
dependencies_s | dependencies_s | ||
- | download_wiki | + | download_wiki |
- | git hub_wiki | + | github_wiki |
+ | php-max | ||
---- | ---- | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
TeemIp' | TeemIp' | ||
Line 26: | Line 40: | ||
===== Revision History ===== | ===== Revision History ===== | ||
- | ^ Version | + | ^ Version |
- | | 1.0.0 | 2020-10-04 | + | | **3.1.1** |
+ | | 3.1.0 | 2023-04-01 | ||
+ | | 3.0.0 | 2022-01-05 | ||
+ | | 1.0.1 | 2021-04-01 | ||
+ | | 1.0.0 | 2020-10-04 | ||
===== Features ===== | ===== Features ===== | ||
Line 36: | Line 54: | ||
* Company name, address and country | * Company name, address and country | ||
* Last update | * Last update | ||
+ | |||
+ | ===== Licensing ===== | ||
+ | The TeemIp MAC Address Lookup extension is licensed under the terms of the GNU Affero General Public License Version 3 as published by the Free Software Foundation. This gives you legal permission to copy, distribute and/or modify TeemIp MAC Address Lookup under certain conditions. Read the ’license.txt’ file in the TeemIp distribution. TeemIp MAC Address Lookup is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE WARRANTY OF DESIGN, MERCHANTABILITY, | ||
+ | |||
+ | The extension relies on [[https:// | ||
===== Limitations ===== | ===== Limitations ===== | ||
The extension relies on the public web site https:// | The extension relies on the public web site https:// | ||
+ | The 3.0.0 version is not compatible with TeemIp' | ||
+ | |||
===== Requirements ===== | ===== 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. | 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. | ||
Line 48: | Line 73: | ||
When adding the module on an iTop application, | When adding the module on an iTop application, | ||
- | |||
- | ===== Licensing ===== | ||
===== Configuration ===== | ===== Configuration ===== | ||
Line 57: | Line 80: | ||
===== MAC Lookup menu ===== | ===== MAC Lookup menu ===== | ||
- | Once installed, the extension will alter the IP Management menu by adding the sub menu "MAC Lookup" | + | Once installed, the extension will alter the IP Management menu by adding the sub menu "MAC Lookup" |
- | {{ details_menu_maclookup.png }} | + | {{ details_menu_maclookup3x.png }} |
Clicking on this menu will open the following form where either a MAC address or a MAC address prefix can be entered. | Clicking on this menu will open the following form where either a MAC address or a MAC address prefix can be entered. | ||
- | {{ maclookup-form.png }} | + | {{ maclookup-form3x.png }} |
When the form is applied, a lookup request is sent to the [[https:// | When the form is applied, a lookup request is sent to the [[https:// | ||
- | {{ maclookup-output-from-form.png }} | + | {{ maclookup-output-from-form3x.png }} |
+ | ==== Output parameters ==== | ||
+ | All parameters contained in MACLookup answer are described in [[https:// | ||
+ | |||
^ Parameter | ^ Parameter | ||
- | | Block start | Start MAC range | | | + | | Prefix | Prefix of the MAC addres | | |
- | | Block end | End MAC range | | | + | | Block start | Start MAC range | | |
+ | | Block end | End MAC range | | | ||
| Block size | Number of possible unique MAC for this prefix | | Block size | Number of possible unique MAC for this prefix | ||
- | | Block type | Assignment Type \\ < | + | | Block type | Assignment Type \\ * MA-L: MAC Address Block Large (previously named OUI). Number of address |
- | * MA-M: MAC Address Block Medium. Number of address | + | |
- | * MA-S: MAC Address Block Small (previously named OUI-36, encompasses IAB Assignments). Number of address | + | |
- | * CID: Company Identifier. This prefix will not be used for globally unique applications. Number of address | + | |
| Company | Company name | | | | Company | Company name | | | ||
| Address | Company address | | Address | Company address | ||
| Country | Company country | | 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 | | | 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 | | | + | | Private | The company prevents their name and address from showing up in the public listing | Optional |
+ | |||
+ | |||
+ | ===== MAC Lookup from CIs ===== | ||
+ | When the details of a CI are displayed, an analysis is done to check if the CI has at least one MAC address attribute (of class " | ||
+ | {{ details_otheractions_maclookup3x.png }} | ||
- | * MA-M: MAC Address | + | If MAC Address |
- | -- FIXME -- | ||
- | Documentation to be completed. | ||
+ | {{ maclookup-output-from-ci3x.png }} |