Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from this space and version 8.0.0

...

LIR Walkthrough


Info
titleBefore You Begin

Before you begin, determine who in your organization has access to the RIR API Keys related to the ASNs used by your organization and gather the following data:

For ARIN, you will need to gather data for the ASN, Org ID, Admin/Tech/Abuse POCs, Name Prefix, and API Keys for each ASN. 

For all other RIRs, you will need information for the Maintainer, Password, and Admin/Tech Contacts per ASN.


Table of Contents

Create LIRs

First, go and set up an LIR from Admin → IPAM Admin.

...

We can verify this information by querying the ARIN database, like so:

No Format
https://whois.arin.net/rest/org/CONNE-81/pft?s=conne-81 
https://whois.arin.net/rest/poc/6CONN-ARIN?s=6conn-arin

Once you have an LIR in ProVision, it is trivial to query the API of its resource from the ProVision database using the resource Id number.

...

From here, ensure that IP space has been entered into ProVision, along with necessary Contacts and Resources.

Associate Contacts with the Resources, and assign IP space to the necessary Resources.  See: Working with ResourcesWorking with EntriesContact Manager, and Working with IP Blocks.

Ensure Make sure that you have followed the following guidelines:

  • Danger #1: Make sure you own the IP space in question. ARIN knows who is supposed to be administering every bit of IP space under its domain, and you will run into issues if you do not actually own the IP space according to the RIR.
  • Danger #2: Make sure the IP space is actually assignable with ARIN. 


Info
titleAn example of why SWIPs might fail

Lets imagine that 10 years ago some network administrator did a simple assignment with ARIN which noted that a certain /26 was under management by Company A. Since then, that administrator has been fired, the company he worked for has been acquired, that company was then itself acquired, and Company A has gone bankrupt and dissolved.

Today, nobody knows about all this. But ARIN remembers that a certain /26 has been delegated to Company A, and nobody has informed them otherwise. This is a not-uncommon issue.

So today, you come along and you are doing your tests with a /28 which happens to be a sub-block of the /26. You can configure everything correctly and despite that, ARIN will completely refuse to SWIP the /28, because ARIN thinks that the /28 is part of a /26 which is already SWIP'd.

To make matters worse, ARIN won't tell you why it is refusing to SWIP the /28 -- it will just tell you its invalid. The only way to debug this situation is manually probe the ARIN database until you find the already-SWIP'd block, construct this block in ProVision, try to SWIP it (and fail, because it is already SWIP'd), then de-SWIP it, clearing the erroneous state both from ProVision and from ARIN. Due to a lack of access to the ARIN database, ProVision is limited in its methods of handling situations such as these.

...

database (nope), then it looks for blocks it *does* know about it which contains it. Here we see 6connect's /20 as its immediate owner:

No Format
https://whois.arin.net/rest/net/NET-67-221-240-0-1

And ARIN's own base allocation as the next-highest owner:

No Format
https://whois.arin.net/rest/net/NET-67-0-0-0-0

The story of this block is therefore: "ARIN was given this IP Block by ICANN, then ARIN did a Direct Allocation of a /20 to 6connect." And in a bit here, 6connect will do a detailed re-assign to MedaTeckle, a made-up company whose headquarters is the birthplace of Genghis Khan.

Here is my the resource:

And here are the contacts:

...

Having someone in the 'ARIN-NET' and the 'ARIN-ADMIN' roles is required for a Detailed Reassign. As I mentioned with Joe earlier, it It is currently not possible to have a single Contact with both roles, so you'll need two contacts listed.

Here is the last piece, our IP block:

...

Our /27 has been delegated to our new fake company, here:

No Format
https://whois.arin.net/rest/net/NET-67-221-244-160-1


A new ARIN entry for the fake company has been automatically made:


No Format
https://whois.arin.net/rest/org/MEDAT-1.html

...



https://whois.arin.net/rest/org/MEDAT-1.html


And the relevant Points of Contact have been generated:

No Format
https://whois.arin.net/rest/org/MEDAT-1/pocs

This lets everyone know that if issues arise with that / 27, they know who to contact to resolve the issue.

...